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1. Positioning of TSO/ONTOP 

TSO/ONTOP is part of the ONTOP framework used by software service experts during the 
problem solving process. It is a predefined environment on customer systems for failure 
analysis. 

To get the whole picture of the ONTOP concept, the problem solving process is shown and 
the role TSO/ONTOP is playing in it. 

However, in this manual only TSO/ONTOP will be covered. 



Used Tools: 

1. NVAS/ONTOP 
| TSO/ONTOP 

3. OPUS 

4. BTOP 

5. ONT721 

6. LTOP 

7. RETAIN 


Central Point of Control 

Analysis of problem data on customer systems 

ONTOP administration data 
Mass data transfer between IBM and customers 
IBM internal problem analyzing environment 
IBM internal data transfer environment to the labs 
IBM problem reporting tool 


The problem solution process is iterative and my need to redo one of the steps. 
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2. Responsibilities/Deliveries /Controls 

2.1 Contact addresses 

IBM Deutschland Informationssysteme GmbH 

H. -D. Hassinger / A. Damm 
Kostenstelle 7420 
Gebaudeschliissel 55131-12 
Hechtsheimerstr.2 
D-55131 Mainz 

2.2 Problem Reporting 

In case of problems, please contact => ONTOP Team 

Email: ONTOP@de.ibm.com 

Telephone: 06131-84-5003 
Fax: 06131-84-6611 

Retain: PMS(Problem Management Software) Queue ONTOP,203 

2.3 ONTOP Documentation 

I. ONTOP Antrag fur eine IP Verbindung 

2. Request for an ONTOP IP connection 

3. ONTOP Antrag fur eine SNI Verbindung 

4. ONTOP Flyer 

2.4 ONTOP Code Distribution 

ONTOP Code is available via: 

1. Remote installation by the ONTOP Team 

2. Via Email 

3. Via Diskette 


2.5 ONTOP Change Process 

As TSO/ONTOP runs on customer systems, it is out of IBM control. So every change on a 
customer system effecting ONTOP should be reported to the ONTOP team. This is done by 
sending an Email to ONTOP@de.ibm.com. The ONTOP team will do a test to insure the 
failure analyzing environment is still functional. 
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3. Copyright 

TSO/ONTOP is a facility of IBM Customer Engineering Germany. 

All programs, procedures and documentation of TSO/ONTOP are property of IBM Customer 
Engineering Germany and should not be installed, used, copied, or modified without the 
approval of IBM. TSO/ONTOP remains property of IBM Customer Engineering after 
installation at customer site. 

If the conditions or requirements for ONTOP Service are no longer valid all procedures, 
programs and documentation have to be deleted. 


4. Software Prerequisite s 

• OS/390 

• TSO/E 

• ISPF 

• RACF 

• OS/390-CS 

• JES (optional) 

• at least 4 TSO Userids for ONTOP 
1 maintenance userid 

3 failure analysis userids 

ONTOP should run on all "field installed" OS/390 releases 
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5. ONTOP Online Support 

As IBM software service experts are located all over the world, it makes no sense to use 
TSO/ONTOP without having a network connection between IBM/Customer. This is the only 
way to guarantee, that always the best skill available will be able to work at the problem. 

So before installing TSO/ONTOP one of the following network connections should be 
established. 


5.1 IP-Connection 

This is where the customer just needs the ONTOP connection. 

It is an ISDN/PPP/IP dial connection between Mainz and the customer location. 


5.2 Non-Switched-Connections (via AT&T) 

If a customer is planing to use other IBM services besides ONTOP, he can sign a connect 
contract with AT&T, to get a non-switched network connection IBM/customer (SNA or IP). 
ONTOP can participate on the connection established by AT&T. 
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Connection Overview 

This figure shows the possibilities of remote connections 

• NON Switched SNI (SNA via AT&T) 

• MPN (SNA or IP via AT&T) 

• IP (via IT-Center Mainz) 
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6. ONTOP Security 

All ONTOP connections follow the IBM IES (Inter Enterprice Secuty) gateway guidelines on 
the IBM site, what means those connections are controlled and documented. 


6.1 IBM site 

1. Connections to customers only via certified IES gateway 

2. Only authorized users can use ONTOP via userid/password 

3. All activities will be logged and captured for 60 days 

4. All security violations will be traced 

5. All customer data is treated "CONFIDENTIAL" 


6.2 Customer site 

1. Activate Line only on IBM request (switched connections) 

2. Install IBM supplied COS entry (SNA Logmode check) 

3. Check IBM supplied Terminal-IDs (CDRM/CDRSC coding - SNA connections) 

4. Permit ONTOP TSO userid/password only per session 

5. Use RACF 

6. Modify ONTOP LOGON Procedure (TOPLOG) to your needs 

7. Use TOPALLOW for permission, tracking of IBM LOGON 

8. Modify ONTOP ISPF Command table (TOPCMDS) to your needs 

9. Log activities at your system 


Conclusion 

The ONTOP environment can be tailored to every individual security need. 
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7. Introduction to TSO/ONTOP 

TSO/ONTOP is a REXX/ISPF application which will be installed on customer systems to set 
up a predefined failure analysis environment for software service experts. 

It consists of the following parts: 

7.1 Customize 

This is a menu driven environment for doing the ONTOP customization activities. 

If the customer follows the IBM suggested password management, then the password 
administration can also be done here. 

7.2 Browse 

Here the customer can define up to 5 high level qualifiers for ONTOP to browse. 

This is only necessary if direct ISPF access is not allowed. 

7.3 EDIT 

Own user environment where she/he should be allowed to EDIT it’s own data. 

7.4IPCS 

IPCS is used by software service experts to analyze dumps and traces captured for failing 
software components. 

TSO/ONTOP Interactive Problem Control System serves a Multiple Dump Environment 
(MDE). MDE is the capability of the tool to allow different product level to be analyzed on 
one system, by allocating the appropriate libraries. 

This is achieved by using control tables. There is one environment control table and several 
data set control tables. Each data set control table reflects a separate environment. All the 
allocations to the DDnames will be done based on the control table entries. 

So with a system complex where data sets are located on shared DASD, ONTOP only needs 
to be installed once, but has access to the relevant dump data sets of all the systems and can 
switch between them. 

7.5EREP 

More or less a traditional feature of ONTOP. Today's hardware has it’s own error recording 
facilities and doesn’t use EREP any longer. However, soft records are still processed by 
EREP, but those can be selected under IPCS as well. So this feature is by default not active 
under ONTOP, but can be activated, if the customer sees any need in it. 


12 


TSO/ONTOP Inst/Cust/Usage Guide 


17.10.01 






A ONTOP 


7.6IND$FILE 

Option to exchange data between IBM and customers via PC. 

7.7TERSE 

Used to terse data to be exchanged between IBM and customers. 

7.8SDSF 

If customer has JES2 installed, then this function should be activated, to allow IBM experts, 
to have a look to the running system. 

7.9ISPF 

ISPF is the standard ISPF environment which is established by calling ISR§PRIM. 
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8. ONTOP startup 

8.1 ONTOP startup flow 

TOPLOG 

TOPFIRST ◄-► TOPALLOW-►! Permission DS 

TOPPROI ◄-► TOPQUAL 

I_ 

TOPGENL — 

I 

TOPINI 

I 

TOPALLL 

I 

TSO/READY 
TSOLIB 

TOPSTART 

TOPHOME 



ONTOP startup flow 
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8.2 Description of ONTOP startup flow 

This describes the ONTOP startup flow, from the LOGON procedure up to the ISPF 
environment. 

• TOPLOG 

TOPLOG is the ONTOP Logon Procedure. 

It allocates the ISPF Clist and the ONTOP Clist to DDname SYSPROC and invokes 
TOPFIRST. 

• TOPFIRST 

TOPFIRST is the first ONTOP EXEC. It calls TOPALLOW and TOPPROI. 

• TOPPROI 

TOPPROI is the EXEC responsible for the house keeping. 

- It requests ont_pref/ont_prof from TOPQUAL 

- It allocates the ONTOP ISPF Profile 

- It copies member TOPPROF from TOPCNTL to ISPPROF 
(but only, if there is no TOPPROF on ISPPROF) 

- It copies member TOPENVTO from TOPCNTL to ISPPROF 
(but only, if there is no TOPENVTO on ISPPROF) 

(or there is a new TOPENVTO version on TOPCNTL) 

- It invokes TOPGENL the ONTOP allocation EXEC builder 

• TOPQUAL 

TOPQUAL is a standard routine to provide the ONTOP profile name "ont_prof", the 
ONTOP prefix "ont_pref" and the ONTOP maintenance userid "ont_main". 

• TOPGENL 

TOPGENL is the EXEC to generate the ONTOP allocation EXEC TOPALLL. 

TOPALLL is build based on the dump environment control table TOPENVTO and the 
related data set allocation control table TOPENVnn, where nn is the environment number 
given by the asterisk row 
in table TOPENVTO. 

These are the steps done by TOPGENL: 

- read TOPENVTO (dump environment control table) 

- check TOPENVTO to find active environment 

- read TOPENVnn data set control table selected by TOPENVTO 

- pick out customer defined libraries 

- check for availability of the libraries 

- build TOPALLL EXEC 

- write TOPALLL EXEC to ONTOP profile data set 

• TOPINI 

It calls the ONTOP allocation EXEC TOPALLL. 
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• TOPALLL 

This is the EXEC generated by TOPGENL. It allocates all data sets of the selected - in the 
first place default - dump environment. 

In order to switch the dump environment, TSOLIB is needed, which cannot be executed 
under REXX. 

So it has to be pushed to run under TSO/READY. 

Also pushed is TOPSTART the ONTOP ISPF starting EXEC. 

• TOPSTART 

Start ISPF environment 

• TOPHOME 

Display ONTOP LOGO, ONTOP Base Message and select the ONTOP Home Panel 
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9. ONTOP dump environment switching 

9.1 ONTOP dump environment switching flow 


> TOPRELO 


TOPPROI < 


TOPGENL — 

I 

TOPINI 

I 

TOPALLL 

I 

TSO/READY 

TSOLIB 


TOPSTART 


TOPHOME 


Hon 

3 H 

ne Panel 

1 

r 


Selection 

S 


> TOPQUAL 


ISPPROF TOPCNTL 


TOPPROF 

◄- 

TOPPROF 

TOPENVTO 

◄- 

TOPENVTO 



TOPENVIO 

TOPALLL 


TOPENVI1 



TOPENVnn 


ONTOP environment switching 


9.2 Description of ONTOP environment switching flow 

This describes how the dump environment is switched. 

It is a duplicate of the LOGON flow, except TOPSTART calls TOPRELO which starts the 
logon phase again with a different data set allocation control table (TOPENVxx). 


17.10.01 


TSO/ONTOP Inst/Cust/Usage Guide 


17 











ontopA 


10.Dump Environment Philosophy 

10.1 Layout of Dump Environment Philosophy 



Dump Environment philosophy 
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10.2 Description of Dump Environment Philosophy 

Based on the environment control table TOPENVTO and the data set allocation control tables 
TOPENVnn individual dump environments can be established. 

When TOPENVIO (the ISPF table) is shown to the user, the dump environment reflected by 
the asterisk is active. 

In the example environment 3 is the active one. So all the data sets owned by TOPENV03 
will be active. 

To switch a dump environment just select a different one and press ENTER. Each envi¬ 
ronment switch automatically forces an ISPF restart. This is due to the fact that TSOLIB 
(used to allocate the load libs) only allows to switch allocation under TSO/READY, which 
is performed transparent to the user during the ISPF restart process. 

It is possible to have several different dump environments under one OS/390 level. 

The installation standard is 3 environments: 

1. bringup 

2. default 

3. free 
The limit is 99. 

In order to stay within a reasonable maintenance effort, it is always advisable to keep the 
environments as small as possible. 

Each dump environment is unique. 

Environment specific LIBs 

• MIGLIB 

• PARMLIB 

• DUMP Directory 

• IPCS Libs 

• Product Libs 

Fixed LIBs 

• ISPF LIBs 

• ONTOP LIBs 
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11. Examples of Control Tables 


11.1 Dump Environment Control Table TOPENVTO 


**TOPENVTO*********************************************************** 

★ •k 

★ DUMP ENVIRONMENT SELECTION TABLE * 

★ ★ 

* HINWEIS: ASTERISK IN COLUMN 1 MEANS COMMENT. * 

* A NEW ENVIRONMENT SHOULD ALWAYS BE PLACED AT THE END * 

* OF THE TABLE. * 

* THE ASTERISK UNDER COLUMN "F" SHOULD NOT BE MOVED AND * 

* ALWAYS POINT TO THE BRINGUP ENVIRONMENT. * 

* UNUSED FIELDS MUST BE PADDED BY DASHES (-) * 

* ★ 

* BY DEFAULT, THERE ARE 3 ENVIRONMENTS AVAILABLE. * 

* ENVIRONMENT 1 IS THE BRINGUP ENVIRONMENT JUST USING THE ONTOP, * 

* ISPF AND IPCS LIBRARIES. THIS IS TO MAKE SURE ONTOP CAN ALWAYS * 

* BE STARTED. PLEASE MODIFY THE USED DATASETS IN TABLE TOPENVOl * 

* TO REFLECT THE DATSETS ON YOUR SYSTEM. * 

* ENVIRONMENT 2 IS AN EXAMPLE AND SHOULD BE MODIFIED ACCORDING * 

* THE PRODUCT LEVELS INSTALLED ON THE SYSTEM. IN TABEL TOPENV02 * 

* YOU MUST CHANGE THE DEFAULT DATASETS AND ADD THE PRODUCT * 

* DATASETS. * 

* ALL THE OTHER INVIRONMENTS, UP TO 99, CAN BE USED FOR ALL KIND * 

* OF DIFFERENT ANALYZING SZENARIOS. * 

* THE PREDIFINED TABLE TOPENVO3 SHOULD BE CHECKED AND EVEN IF NOT * 

* USED MODIFIED ACCORDING TO THE SYSTEM ENVIRONMENT. * 

* ★ 

* AFTER FINISHING WITH THIS TABLE AND ALL THE DATASET CONTROL * 

* TABLES TOPENVOl - TOPENVNN, PLEASE USE ONTOP OPTION 3 AND * 

* SWITCH OVER ALL ENVIRONMENTS, TO MAKE SURE YOU DID NOT ADD * 

* INVALID DATSETS. * 

* ■k 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★it 


/390 ! 

IMS 

! CICS! 

DB2 ! 

! JES2! 

VTAM! 

TCPIP! 

MQS ! 

! COMMENT ! 

! F ! 

! S 

TOP ! 

TOP 

! TOP ! 

TOP 

TOP ! 

TOP ! 

TOP ! 

TOP 

BRINGUP 

★ 

01 

603 ! 

410 

! 410 ! 

410 

130 ! 

440 ! 

320 ! 

? ? ? 

/390 2.03 

- 

02 

608 ! 

610 

! 610 ! 

610 

208 ! 

208 ! 

208 ! 

? ? ? 

/390 2.08 

- 

03 

703 ! 

610 

! 610 ! 

610 

210 ! 

210 ! 

210 ! 

? ? ? 

/390 2.10 

- 

04 


Dump environment control table TOPENVTO 
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11.1 Data Set Allocation Control Table TOPENV02 


* *TOPENV02 * *************************** 

******************************* 

•k -k -k 

* DATA SET ALLOCATION CONTROL TABLE 


k 

* HINWEIS: ASTERISK IN COLUMN 1 MEANS 

COMMENT. 

* 

* The following product levels will be 

covered by this table: 

* 

* OS/390 603 


* 

* IMS 410 


* 

* DB2 410 


* 

* CICS 410 


* 

* JES2 130 


* 

* VTAM 4 4 0 


* 

* TCPIP 320 


* 

************************************** 

******************************* 

k k k 

* 

/* 

*/ 

* ISPCLIB 

/* CLISTS/REXX 

*/ 

ONTOP.V7R3M3.ISPCLIB 

/* ONTOP CLISTS 

*/ 

ISP.SISPCLIB 

/* ISPF CLISTS 

*/ 

OS603.SBLSCLI0 

/* IPCS CLISTS 

*/ 

SYS1.SISTCLS1 

/* VTAM CLISTS 

*/ 

IMS.V4R1M0.DFSCLST 

/* IMS CLISTS 

*/ 

* 

/* 

*/ 

* ISPPLIB 

/* PANEL LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPPLIB 

/* ONTOP PANELS 

*/ 

ISP.SISPPENU 

/* ISPF PANELS 

*/ 

OS603.SBLSPNL0 

/* IPCS PANLES 

*/ 

IMS.V4R1M0.DFSPLIB 

/* IMS PANLES 

*/ 

* 

/* 

*/ 

* ISPMLIB 

/* MESSAGE LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPMLIB 

/* ONTOP MESSAGES 

*/ 

ISP.SISPMENU 

/* ISPF MESSAGES 

*/ 

OS603.SBLSMSG0 

/* IPCS MESSAGES 

*/ 

IMS . V4R1M0 . DFSMLIB 

/* IMS Messages 

*/ 

* 

/* 

*/ 

* ISPSLIB 

/* SKELETON LIBRARIES 

*/ 

ONTOP . V7R3M3 . ISPSLIB 

/* ONTOP SKELETONS 

*/ 

ISP . SISPSENU 

/* ISPF SKELETONS 

*/ 

ISP . SISPSLIB 

/* ISPF SKELETONS 

*/ 

OS603 . SBLSKEL0 

/* IPCS SKELETONS 

*/ 

IMS . V4R1M0 . DFSSLIB 

/* IMS Skeletons 

*/ 

'k 

/* 

*/ 

* ISPTLIB 

/* TABLE INPUT LIBRARIES 

*/ 

ONTOP . V7R3M3 . ISPTLIB 

/* ONTOP TABLES 

*/ 

ISP . SISPTENU 

/* ISPF TABLES 

*/ 

OS603 . SBLSTBL0 

/* IPCS TABLES 

*/ 

IMS.V4R1M0.DFSTLIB 

/* IMS Tables 

*/ 

'k 

/* 

*/ 

* IPCSPARM 

/* IPCS CONTROL MEMBER 

*/ 

OS603 . PARMLIB 

/* MVS PARMLIB 

*/ 

* 

/* 

*/ 

* TSOLIB 

/* LOAD MODULES 

*/ 

OS603.MIGLIB 

/* IPCS MODULES 

*/ 

IMS.V4R1M0.RESLIB 

/* IMS MODULES 

*/ 

DB2 . V4R1M0 . SDSNLOAD 

/* DB2 MODULES 

*/ 

CICS . V4R1M0 . SDFHLINK 

/* CICS MODULES 

*/ 

SYS1 . V1R3M0 . SAHSMIG 

/* JES MODULES 

*/ 

SYS1.V4R4M0.VTAMLIB 

/* VTAM MODULES 

*/ 

TCPIP.V3R2M0.SEZAMIG 

/* TCPIP MODULES 

*/ 

ONTOP.V7R3M3.TOPTERS 

/* TRSMAIN LIB 

*/ 


/* 

*/ 

* END 

/* 

*/ 

Data set allocation table for enviroment 02 
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12. ONTOP IPCS startup 

12.1 Layout of ONTOP IPCS startup 



ONTOP Home Panel 

3^ 



Dump Enviroment Select Panel 


TOPIPCS 


_ TOPENVI 

envi_ret 
. * TOPIPCSA 



MVS 


envi 

- 

520 


02 

* 

601 


03 

- 

624 


04 


TOPENVR 


TOPQUAL 


H 21 3i 


ont_prof 


ISPF + 
restart 



TOPENVTO (sequential) 
MVS F 



★ 



IPCSDDIR 

userid.o_envi.directory 
userid.o_envi.data 
userid.o envi.indx 


IPCSPRNT 

userid.temp.ipcsprint 


IPCSTOC 

userid.temp.ipcstoc 
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12.2 Description of ONTOP IPCS startup 

IPCS is invoked from the ONTOP home panel by selecting option number 3. 

To have one dump directory per environment, each time IPCS is started the environment 
variable "o_envi" is picked up from TOPENVTO the sequential dump control table located on 
ISPPROF. 

Based on this information IPCSDDIR is allocated. 

12.2.1 Program flow of ONTOP IPCS startup 

• TOPIPCS 

TOPIPCS calls TOPENVI to show the environment selection panel to the 
user. Then it checks the variable envi_ret and based on it, 

• (1) returns to the ONTOP Home Panel - PF03 was pressed 

• (2) restarts ISPF - new environment was selected 

• (3) starts TOPIPCSB - ENTER was pressed 

• TOPENVI 

TOPENVI maintains the DUMP environment control table. 

First, the sequential control table TOPENVTO on ISPPROF is read, and the ISPF table 
TOPENVIO is build and displayed. 

If the user decides to change the current dump environment by using select and hitting 
"ENTER", then the sequential table TOPENVTO is rebuild and an ISPF restart is 
performed. If the user decides to go on, he just gets passed to IPCS. 

• TOPIPCSA 

TOPIPCSA calls TOPENVR to read TOPENVTO to retrieve the active environment 
variable o_envi. Based on this variable the IPCS data sets will be allocated. 

• TOPENVIR 

TOPENVIR calls TOPQUAL to retrieve ont_prof (Profile prefix), then it reads 
TOPENVTO (the dump environment control table) to find the active dump environment 
to pass it back to the caller as variable "o_envi". 

• TOPQUAL 

TOPQUAL is a standard routine which can be called from everybody in order to retrieve 
the ONTOP profile name "ont_prof" and ONTOP prefix "ont_pref". 

• TOPIPCSB 

TOPIPCSB is the IPCS environment preparation EXEC. It 

- sets PF-Keys for IPCS 

- manipulates IPCS settings 

- starts IPCS 
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13. IPCS points of view 

13.1 IPCS standard PARMLIB members 

To have a smooth and clean dump environment, it is not only necessary to have individual 
data sets for each dump environment, also the set up for each individual environment has to 
be focused on. 

Here it is not possible, to live without GC28-1461, the IPCS customization manual. 

So some attention should be given to the most important IPCS Members in the PARMLIB. 

• IPCSPRxx 

The IPCSPRxx member defines IPCS session parameters. 

• BLSCECT 

BLSCECT is an IBM-supplied default member of SYS1.PARMLIB. This default member 
embeds BLSCECTX, other IBM-supplied parmlib members and BLSCUSER. 

• BLSCECTX 

BLSCECTX is an IBM-supplied default member of SYS1.PARMLIB. 

This member specifies the format exit routines for IBM programs not in the 
base system. This member also embeds other IBM-supplied parmlib members 
used by MVS components to define their IPCS support. 

• BLSCUSER 

BLSCUSER is an optional parmlib member an installation can create and use for 
customization. IBM does not supply a BLSCUSER member. 
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13.2 IPCS component handling 

OS/390 components like CICS, IMS, DB2, JES2.need special treatment. 

Here are some examples. 

• CICS (DFHIPCSP) 

DFHIPCSP is the CICS component exit member located in hlq.DFHPARM. It has to be 
allocated to the DD-Name IPCSPARM. 

The formatting routines of hlq.DFHFINK must be active. 

• IMS (DFSIPCSP) 

DFSIPCSP is the IMS component exit member located in hlq.MACFIB. It has to be 
allocated to the DD-Name IPCSPARM. 

The formatting routines of hlq.RESFIB must be active. 

• JES2 (HASLIPCS) 

HASFIPCS is the JES2 component exit member located in hlq.SHASPARM. It has to be 
allocated to the DD-Name IPCSPARM. 

The formatting routines of hlq.SHASMIG must be active. 

• JES3 (IATIPCSP) 

IATIPCSP is the JES3 component exit member located in hlq.SIATPARM. It has to be 
allocated to the DD-Name IPCSPARM. 

The formatting routines of hlq.SIATMIG must be active. 
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13.3 IMBED part for "other" products in BLSCECT 


/* IMBED statements for other products are placed after those for 
/* the MVS/System Product but before BLSCUSER and BLSCECTX to 
/* ensure that the basic facilities provided in these products are 
/* not regressed by any definitions in the latter members. 


MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 

MEMBER 


(HASLIPCS) 
(IATIPCSP) 
(IGDIPCSP) 
(DFSIPCSP) 
(DXRIPCSP) 
(DSNIPCSP) 
(ISPIPCSP) 
(IKJIPCSP) 
(IGWIPCSP) 
(DFHIPCSP) 
(CSFIPCSP) 
(BPXIPCSP) 
(CEEIPCSP) 
(EZAIPCSP) 


ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 

ENVIRONMENT 


(ALL) 

(ALL) 

(ALL) 

(ALL) 

(ALL) 

(ALL) 

(ALL) 

(ALL) 

(ALL) 

(ALL) 

(ALL) 

(IPCS) 

(IPCS) 

(IPCS) 


/* JES2 
/* JES3 
/* DFP 
/* IMS 
/* IRLM 
/* DB2 
/* ISPF 
/* TSO/E 
/* DFP 
/* CICS 
/* CSF 
/* OpenMVS 
/* LE/370 
/* TCP/IP 


&P6M*/ 
&P6M*/ 
&L1A*/ 
&L1A*/ 
&L1A*/ 
&L1A*/ 
&L1A*/ 
&L1A*/ 
&L4A*/ 
&DAA*/ 
& 0 5A*/ 
&L6A*/ 
&07A*/ 
&07A*/ 


06752400 

06756200 

06762400 

06768600 

06774800 

06781000 

06787200 

06793400 

06795600 

06797800 

06800000 

06850000 

06900000 

06950000 

07000000 

07050000 

07050900 

07051800 

07052700 

07053600 

07054500 

07055400 

07056600 


IPCS imbed members for "other" products 

This is an example of the component part in Member BLSCECT at PARMLIB. 

13.4 IPCS VERB EXITS at BLSCECTX 


06752400 

00050000 

00694200 

/* ================================================================ */ 00695900 

/* IPCS Verb Exits */ 00700000 

/* ================================================================ */ 00750000 

00800000 

EXIT EP(DSNWDPRD) VERB(DB2DATA,DSNWDMP) ABSTRACT('DB2 analysis') + 00850000 

PARM('TT,ALL,SUMDUMP=YES,SUBSYS=DSN') /* &01C*/ 00900000 

EXIT EP(DFSOFMDO) VERB(IMSDUMP) ABSTRACT('IMS analysis') /* &01C*/ 00950000 

EXIT EP(DXRRLM50) VERB(IRLM) AMASK(X'00FFFFFF') ABSTRACT(+ 01000000 

'IMS Resource Lock Manager analysis') /* &01C*/ 01050000 

EXIT EP(HASPBLKS) VERB(JES2) ABSTRACT('JES2 analysis') /* &01C*/ 01100000 

EXIT EP(IATABPR) VERB(JES3) ABSTRACT('JES3 analysis') /* &01C*/ 01150000 

EXIT EP(IEDPRDMP) VERB(TCAMMAP) AMASK(X'00FFFFFF') ABSTRACT(+ 01200000 

'TCAM control block analysis') /* &01C*/ 01250000 

EXIT EP(IGDERRIP) VERB(SMSDATA) ABSTRACT(+ 01300000 

'SMS control block analysis') /* &01C*/ 01350000 

EXIT EP(IKJVETSO) VERB(TSODATA) ABSTRACT('TSO analysis') /* &P1A*/ 01375000 

EXIT EP(ISTRAFD1) VERB(VTAMMAP) AMASK(X'00FFFFFF') ABSTRACT(+ 01400000 

'VTAM control block analysis') /* &01C*/ 01450000 

01500000 


IPCS imbed members for "other" products 

This is an example of VERB EXITS in Member BLSCECTX in PARMLIB. 
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13.5 IPCS Component panel BLSCOMP 


r 

BLSPCOMP-IPCS MVS DUMP COMPONENT DATA ANALYSIS- 

OPTION ===> _ SCROLL ===> CSR 


To display information, specify "S option name" or enter S to the left 
of the option desired. Enter ? to the left of an option to display 
help regarding the component support. 

S Name Abstract 

_ ALCWAIT Allocation wait summary 


CICSDATA CICS analysis 

CICS212 CICS Version 2 Release 1.2 analysis 

CICS321 CICS Version 3 Release 2.1 analysis 

CICS330 CICS Version 3 Release 3 analysis 

CICS410 CICS Version 4 Release 1 analysis 

CICS510 CICS Version 5 Release 1 analysis 


DFSAAMPR IMS Interactive Dump Formatter 


F1=HELP 

F2=SPLIT 

F3=END 

F5=RFIND 

F6=RCHANGE F7=FORWARD 


F 8 =BACKWARD 

F9=SWAP 

F10=LEFT 

F11=RIGHT 

F12=RETRIEVE 









Panel 

This panel shows the component selection list, after allocating DFHIPCSP for CICS and 
DFSIPCSP for IMS to DD-Name IPCSPARM. 

CICS 

CICS212, CICS321, CICS330, CICS410, CICS510 reflects to the CICS environment and tells 
the user that all the related formatting routines DFHPD212, DFHPD321, DFHPD330, 
DFHPD410 are available. 

IMS 

DFSAAMPR is the IMS primary menu for dump analysis. In the IMS environment the 
following data sets have to be allocated: 


Dsname 

DDNAME 

hlq.DFSCLST 

PROCLIB 

hlq.DFSPLST 

ISPPLIB 

hlq.DFSMLST 

ISPMLIB 

hlq.DFSSLST 

ISPSLIB 

hlq.DFSTLST 

ISPTLIB 

hlq.RESLIB 

TSOLIB 
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13.6 IMS home panel 


DFSAAMPR - 

OPTION ===> 


IMS DUMP FORMATTING PRIMARY MENU 


1 BROWSE 

2 HI-LEVEL 

3 LOW-LEVEL 

4 ANALYSIS 

5 USER 

6 BPE 

7 CQS 

T TUTORIAL 
X EXIT 


IMS formatting initialization and content summary 
Browse Dump dataset (IPCS norm) ************* 

IMS Component level formatting *USERID - HH 

IMS ITASK level formatting *DATE - 98 

IMS dump analysis *JULIAN - 98 

IMS user formatting routines *TIME - 13 

IMS BPE subsystem formatting ^PREFIX - HH 

IMS CQS subsystem formatting ^TERMINAL- 32 

IMS dump formatting tutorial *PF KEYS - 12 

EXIT IMS dump formatting ************* 


HHDM3 

98/01/07 

98.007 

13:54 

HHDM3 

3278 

12 


Enter END or RETURN command to terminate IMS component formattir 


THIS PRODUCT CONTAINS "RESTRICTED MATERIALS OF IBM". * 

5655-158 (C) COPYRIGHT IBM CORP. 1996 * 

LICENSED MATERIALS - PROPERTY OF IBM. ALL RIGHTS RESERVED. * 

U.S. GOVERNMENT USERS RESTRICTED RIGHTS - * 

USE, DUPLICATION, OR DISCLOSURE RESTRICTED BY * 

GSA ADP SCHEDULE CONTRACT WITH IBM CORP. * 

REFER TO COPYRIGHT INSTRUCTIONS FORM NUMBER G120-2083. * 

F2=SPLIT F3=END F5=RFIND F6=RCHANGE F7=FORWARD 


F 8 =BACKWARD 


F10=LEFT 


F11=RIGHT 


F12=RETRIEVE 


Panel 
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14. ONTOP data set members who matter 


14.1 JCL 

ONTOP JCL is located on "prefix.TOPCNTL" 

• TOPLOG => ONTOP LOGON Procedure 


14.2 EXEC'S 

ONTOP EXECs are located on "prefix.ISPCLIB" 

• TOPFIRST => activate TOP ALLOW 

• TOPQUAL => check ONTOP qualifiers 

• TOPPROI => check for STORCLAS, MGMNTCLAS, DATACLAS 

• TOPIPCSA => check for STORCLAS, MGMNTCLAS, DATACLAS 

14.3 Control Members 

ONTOP control files are located on "prefix.TOPCNTL" 

• TOPENVTO => dump environment control table (sequential) 

• TOPENVIO => dump environment control table (ISPF) 

• TOPENVnn => data set control tables 

• TOPBRO => allowed Browse data sets control table 

• CUSNAM => customer name 

• TOPALLOW => logon permission data set 

• JOBCARD => jobcard for data set split 

14.4 ISPF Command Tables 

ONTOP ISPF command tables are located on "prefix.ISPTLIB" 

• TOPCMDS => ONTOP command table 

• BLSGCMDS => IPCS command table 
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15. ONTOP data sets 

15.1 Permanent Data Sets 

• prefix.ISPCLIB => Clists and EXECs 

• prefix.ISPPLIB => Panels 

• prefix.ISPMLIB => Messages 

• prefix. IS PS LIB => Skeletons 

• prefix.ISPTLIB => Command Tables 

• prefix.TOPCNTL => Control Members 

• Prefix.TOPTERS => TRSMAIN (TERSE) 

Note 

ONTOP permanent data sets shouldn't get migrated, or deleted. 

15.2 TEMP Data Sets 

• userid.ONTOP.ISPPROF 

• userid.IPCS.IPCSPRNT 

• userid.IPCS .IPCSTOC 

• userid.ENVInn.DIRECTORY 

• userid.ENVInn.DATA 

• userid.ENVInn.INDX 

• userid.ONTOP.EREP.OUTPUT.OTHER 

• userid. ONT OP .EREP. OUTPUT. TREND 

• userid. ONT OP .EREP. OUTPUT. EXCEPT 

• userid.ONTOP.EREP.OUTPUT.TOURIST 

Note 

ONTOP temporary data sets should not get migrated. 

Better have them deleted before SMS does move them. 


=> ONTOP PROFILE 
=> IPCS print data set 
=> IPCS Table Of Contents data set 
=> IPCS environment dump directory 
=> data part of dump directory 
=> index part of dump directory 
=> non TREND/EXCEPT data 
=> Trend data 
=> Exception data 
=> EREP run data 
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16. Steps to prepare the ONTOP environment 

1. Pre-Activity 

• Have at least 1 maintenance userid and 3 work userids ready for ONTOP 

• ONTOP Userids should have a region size of 256MB 

• Do the RACF setup for ONTOP 

2. Load ONTOP code from PC to Host-Side (see “Loading ONTOP”) 

All ONTOP JCL files are in prefix.TOPCNTL 

3. Adapt control files to your system environment 

All ONTOP control files are in prefix.TOPCNTL 

• Move Logon Procedure TOPLOG to PROCLIB and adjust to your system 

• Adjust TOPENVOl according to your needs 

4. Inspect the EXECs that count 

All ONTOP EXECs are in prefix.ISPCLIB 

• see TOPFIRST with respect to TOPALLOW usage 

• see TOPQUAL with respect to the prefixes you are using 

• see TOPPROI with respect to data set allocation 

• see TOPIPCSA with respect to data set allocation 

5. Customization of ONTOP 

• see customization part and online help under Customization 

6. Do an ONTOP function test 

• see ONTOP function test 

7. Tailoring for EREP 

• See Online Help under Tailoring 


Activities 1 to 4 are necessary to activate ONTOP 
Activities 5 to 7 are necessary to be able to use ONTOP 
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17. RACF setup for ONTOP data sets 

17.1 Dedicated HLQ (High Level Qualifier) 

It is recommended to use a dedicated High Level Qualifier for ONTOP data sets on customer 
systems. Preferred is “ONTOP.*”. If this is not possible, the alternative would be 
“customer_hlq.ONTOP.*” 

So all data belonging to ONTOP should be found under this HLQ. 

17.2 Maintenance Userid/Dedicated HLQ (High Level Qualifier) 

There must be a maintenance userid to maintain the ONTOP environment. 

This userid should have ALTER access to the ONTOP HLQ. 

17.3 Work Userids 

Those are the userids used by IBM software service for failure analysis. They need only 
READ access to the ONTOP data sets. 

17.4 ONTOP data set access list 



User-ID Access 

DS-Name 

maint. User-ID 

work UidOl 


work Uidnn 

prefix.ISPCLIB 

alter 

read 


read 

prefix. IS PPLIB 

66 

66 


66 

prefix. IS PMLIB 

66 

66 


66 

prefix. IS PS LIB 

66 

66 


66 

prefix. IS PTLIB 

66 

66 


66 

prefix.TOPCNTL 

66 

tt 


66 

prefix .TOPTERS 

66 

66 


66 


17.5 Steps to get the RACF environment ready for the ONTOP data sets. 

• Add a profile 

This has to be done for each ONTOP data set. 

• Maintain the access list 

This has to be done for each user, or just once for a group when all ONTOP users are put 
into a group, what is recommended. 

However, the maintenance user always needs to be handled separately, as he needs alter to 
the ONTOP data sets. 

The next pages give a brief overview about this. 

Attention: “Add a group profile” and “Add or change a user connection” is not explained. 
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17.6 ADD Dataset Profiles 


r 

OPTION ===> 


RACF - SERVICES OPTION MENU| 


SELECT ONE OF THE FOLLOWING: 

-> 1 DATA SET PROFILES 

2 GENERAL RESOURCE PROFILES 

3 GROUP PROFILES AND USER-TO-GROUP CONNECTIONS 

4 USER PROFILES AND YOUR OWN PASSWORD 

5 SYSTEM OPTIONS 

6 REMOTE SHARING FACILITY 
99 EXIT 

Licensed Materials - Property of IBM 
5695-039 (C) Copyright IBM Corp. 1983, 1994 
All Rights Reserved - U.S. Government Users 
F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE 

F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE 



RACF SERVICES OPTION MENU 


Follow the appropriate subsequent RACF panels 

• => 1 ADD Add a profile 

• => PROFILE NAME ===> prefix.nnnnnnnn 

• => ENTER OR CHANGE THE FOLLOWING INFORMATION: 

This has to be done for each ONTOP dataset. 
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17.7 Maintain the access list 


r 

OPTION ===> 


RACF - SERVICES OPTION MENU| 


SELECT ONE OF THE FOLLOWING: 

-> 1 DATA SET PROFILES 

2 GENERAL RESOURCE PROFILES 

3 GROUP PROFILES AND USER-TO-GROUP CONNECTIONS 

4 USER PROFILES AND YOUR OWN PASSWORD 

5 SYSTEM OPTIONS 

6 REMOTE SHARING FACILITY 
99 EXIT 

Licensed Materials - Property of IBM 
5695-039 (C) Copyright IBM Corp. 1983, 1994 
All Rights Reserved - U.S. Government Users 
F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE 

F7=UP F8=DOWN F9=SWAP F10=LEFT FI1=RIGHT F12=RETRIEVE 

\ _ J 


RACF SERVICES OPTION MENU 


Follow the appropriate subsequent RACF panels 

• => 4 ACCESS Maintain the access lists 

• => PROFILE NAME ===> prefix.nnnnnnnn 

• => 1 ADD Add users or groups. 

• => SPECIFY ===> yes 

• => Enter the access authority to be granted: 

This has to be done for each user, or just once for a group, when the recommended group 
concept is used. 

Attention: The maintenance user also needs “ALTER” to the ONTOP data sets 
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18 . ONTOP userid and password administration 


18.1 Implementation 

To implement the ONTOP userid/password administration as simple and secure as possible, 
the following RACF concept is recommended. 

• Create the ONTOP userids by using the following attributes: 

- DEFAULT-GROUP = Onnnnnnn - (nnnnnnn = 7 digit customer number) 

- PASS-INTERVAL = 3 

• Create a group called ONTOP 

• Connect all ONTOP users to group ONTOP 

• Grant “SPECIAL” to the ONTOP maintenance user - (default ONTOPOO) 

(This user must at least have update to data set *.*.TOPCNTL) 

Along with the userid administration routines delivered by ONTOP, this set up provides a 
“push button solution” to the human doing the userid/password administration. 

18.2 Usage 

For customers it is optional to maintain userid/password administration themselves, or leave 
it to the ONTOP team. If not left to the ONTOP team, customers should only provide an 
ONTOP userid if the requester is able to name the problem number he likes to work on. In 
case of uncertainty customers should ask for the IBM employee number and cross check with 
the ONTOP help desk, phone 06131-84-5003. 

Remark: The initial password is always Onnnnnnn and therefore not distributed. 

The user must enter a new password during logon. 


Advantages: 

• No password distribution 

• Only people knowing the problem number will receive a userid 

• Only people knowing the customer number will be able to use the userid 

• Personalized passwords as 1:1 relation for user : password is guaranteed 

This concept demands a minimum of 3 ONTOP userids. Depending on problem occurrence 
the number of userids should be increased. 

If there is a problem in using a dedicated ONTOP admin userid, it is also possible to use any 
other userid, as long, as the following prerequisites will be met: 

• Userid has the authority to reset the passwords for the ONTOP users. 

• Userid has at least update access to all the ONTOP data sets 

Additional customer requests can be reflected, as long as they follow the ONTOP concept. 
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19. Loading the ONTOP code 

19.1 Install ONTOP from Diskette 

Upload the ONTOP data sets from PC to Host (i.e. using MS-DOS) 

send cli Bontop.transmit.cli' LRECL(80) BLKSIZE(3120) 

send msg Bontop.transmit.msg' LRECL(80) BLKSIZE(3120) 

send pnl B:'ontop.transmit.pnl' LRECL(80) BLKSIZE(3120) 

send ski B:'ontop.transmit.ski' LRECL(80) BLKSIZE(3120) 

send tbl Bontop.transmit.tbl' LRECL(80) BLKSIZE(3120) 

send topcntl B:'ontop.transmit.topcntl' LRECL(80) BLKSIZE(3120) 

send topters B:'ontop.transmit.topters' LRECL(80) BLKSIZE(3120) 

The data sets are temporary and can be deleted after the installation. B is your 
327O-Emulation-ID. 

Unpack the data sets on the Host by using “receive” 

Open a ISPF Command Shell and enter the following statement 

receive indsname( 1 ontop.transmit.cli') 

After this message 

INMR901I Dataset TOP.PROD.V7R3M3.ISPCLIB from uid on node 
INMR906A Enter restore parameters or 'DELETE' or 'END' + 

type 

dsn('ONTOP.V7R3M3.ISPCLIB') 

‘ONTOP.V7R3M3.xxx’ is your ONTOP-Qualifier. 

Repeat this step for all the ONTOP data sets 
(For Out-Dataset names see the table below). 


Name of Transmit-Dataset 

Name of Out-Dataset 

'ONTOP.TRANSMIT.CLI' 

'ONTOP.V7R3M3.ISPCLIB' 

'ONTOP.TRANSMIT.MSG' 

'ONTOP.V7R3M3.ISPMLIB' 

'ONTOP.TRANSMIT.PNL' 

'ONTOP.V7R3M3.ISPPLIB' 

'ONTOP.TRANSMIT.SKL' 

'ONTOP.V7R3M3.ISPSLIB' 

'ONTOP.TRANSMIT.TBL' 

'ONTOP.V7R3M3.ISPTLIB' 

'ONTOP.TRANSMIT.TOPCNTL' 

'ONTOP.V7R3M3.TOPCNTL' 

'ONTOP.TRANSMIT.TOPTERS' 

'ONTOP.V7R3M3.TOPTERS' 


Attention: If High Level Qualifier ONTOP is not available, any other qualifier will do it, 
e.g. “SYSP.ONTOP.V7R3M3.*”. 
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19.2 Remote installation by the ONTOP-Team 

This is the easiest way. The ONTOP-Team loads ONTOP to your System and does 
the customization. For this work the Team needs a TSO-Userid on your system. 

19.3 Installation via Email 

The ONTOP-Team sends the ONTOP-Datasets via Email. Detach the data sets to 
your PC and follow the instruction for “Install ONTOP from Diskette”. 
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20. Adapting control Files 


After the ONTOP code is moved from “where ever” to customer dasd it is not possible to 
start ONTOP right away. 

As the customer system is "unknown" to ONTOP, the LOGON procedure TOPLOG and the 
allocation control member TOPENVOl have to be modified. 


20.1 Logon Procedure TOPLOG 


/7 *******-_ 

//******* 

//******* 
//******* 
/7 *******__ 
//* Hinweis 
//* 

//******* — 
//TOPLOG 
//SYSPROC 
// 

//SYSHELP 


TSO LOGON PROCEDURE FOR ONTOP 


: please replace SYSPROC and SYSHELP data sets according 
to your installation 


EXEC PGM=IKJEFTO1,DYNAMNBR=60,REGION=OK,PARM='%TOPFIRST' 
DD DSN=ISP.SISPCLIB,DISP=SHR 
DD DSN=0NT0P.V7R3M3.ISPCLIB, DISP=SHR 
DD DSN=SYS1.HELP, DISP=SHR 


ONTOP Logon Procedure 


Actions: 


• move TOPLOG from prefix.TOPCNTL to your logon procedure data set 

• modify TOPLOG as stated under Hinweis. 
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20.2 Adjust TOPENVOI 

This is a default data set allocation control member TOPENVOI, as delivered by ONTOP. 
Five of those default members will be available as a base for individual modification. 


* * TOPENVO1************************************************************** 

* DATA SET ALLOCATION CONTROL TABLE * 


* HINWEIS: ASTERISC IN COLUMN ONE MEANS COMMENT 


* The following product levels will be covered by this table: 

* - DEFAULT TABLE, ONTOP ISPF and IPCS ONLY - 


* 


* 

'k 


* 

*************************** 

****************************************** 

* * * 

* 

/* 

*/ 

* ISPCLIB 

/* CLISTS/REXX 

*/ 

ONTOP.V7R3M3.ISPCLIB 

/* ONTOP CLISTS 

*/ 

ISP.SISPCLIB 

/* ISPF CLISTS 

*/ 

SYS1.SBLSCLIO 

/* IPCS CLISTS 

*/ 

* 

/* 

*/ 

* ISPPLIB 

/* PANEL LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPPLIB 

/* ONTOP PANELS 

*/ 

ISP.SISPPENU 

/* ISPF PANELS 

*/ 

SYS1.SBLSPNLO 

/* IPCS PANELS 

*/ 

* 

/* 

*/ 

* ISPMLIB 

/* MESSAGE LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPMLIB 

/* ONTOP MESSAGES 

*/ 

ISP.SISPMENU 

/* ISPF MESSAGES 

*/ 

SYS1.SBLSMSGO 

/* IPCS MESSAGES 

*/ 

'k 

/* 

*/ 

* ISPSLIB 

/* SKELETON LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPSLIB 

/* ONTOP SKELETONS 

*/ 

ISP.SISPSENU 

/* ISPF SKELETONS 

*/ 

ISP.SISPSLIB 

/* ISPF SKELETONS 

*/ 

SYS1.SBLSKELO 

/* IPCS SKELETONS 

*/ 

* 

/* 

*/ 

* ISPTLIB 

/* TABLE INPUT LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPTLIB 

/* ONTOP TABLES 

*/ 

ISP.SISPTENU 

/* ISPF TABLES 

*/ 

SYS1.SBLSTBLO 

/* IPCS TABLES 

*/ 

* 

/* 

*/ 

* IPCSPARM 

/* IPCS CONTROL MEMBER 

*/ 

SYS1.IBM.PARMLIB 

/* MVS PARMLIB 

*/ 

SYS1.PARMLIB 

/* MVS PARMLIB 

*/ 

ik 

/* 

*/ 

* TSOLIB 

/* LOAD MODULES 

*/ 

SYS1.MIGLIB 

/* IPCS MODULES 

*/ 

ONTOP.V7R3M3.TOPTERS 

/* TRSMAIN LIB 

*/ 

* 

/* 

*/ 

* END 

/* 

*/ 


Data set allocation control table 

Actions: 

• Fill in the necessary data sets to satisfy your environment 

• ISPCFIB 

P CFISTS/EXECs 

• ISPPFIB 

P Panels 

• ISPMFIB 

P Messages 

• IS PS FIB 

P Skeletons 

• ISPTFIB 

P Tables 

• IPCSPARM 

P PARMFIBS 

• TSOFIB 

P Programs/Modules 
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21. Inspecting EXECs 


21.1 TOPFIRST ONTOP first EXEC 


Attention: This step is only necessary if TOP ALLOW is used ! 


/*REXX* 
/* 

/* 


'ONTOP' 

IBM TECHNISCHER AUSSENDIENST 


LEVEL: V7R3M3 

PROGRAM NAME: 

TOPFIRST 




PROGRAM LANGUAGE: 

RE XX 




PROGRAM AUTHOR: 

HHD 




DATE WRITTEN: 

02/06/98 




PROGRAM DESCRIPTION: 

This program does the following: 

- It does call TOPALLOW 
(but only, if active) 

- It does call TOPPROI 



CALLED BY: 

TOPLOG 

- ONTOP 

LOGON 

Procedure 

EXTERNAL ROUTINES: 

TOPALLOW 

TOPPROI 

- ONTOP 

- ONTOP 

permission EXEC 
house keeping EXEC 

INTERNAL ROUTINES: 

none 




DATA SETS READ FROM: 

none 




DATA SETS WRITTEN TO: 

none 




PARAMETERS PASSED IN: 

none 




PARAMETERS PASSED OUT 

: none 




Hinweis: If customer likes to get 
must activate TOPALLOW. 

informed 

about 

IBM LOGON, he 


CHANGE HISTORY: 


DESCRIPTION: 


Trace 'o' 




JUST FOR TRACING 


/* call TOPALLOW 
call TOPPROI 


permission EXEC 
house keeping EXEC 


OK. THAT'S IT || 


TOPFIRST EXEC 

Action 

• Just activate TOPALLOW 
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Description of TOPALLOW 

Each time IBM logs on to the customer system, there will be a log entry in the permission 
data set and customer operation has to reply with "U" before the remote user can pass 
through. 

In order to have this setup functional, customer must create a sequential data set with 
expiration date ahead of the current date and allow IBM to update this data set. 

Default name of the data set is: ONTOP.START.ERLAUBT 

See customization for how to adjust control member TOPALLOW. 

Note 

It might be helpful to have a none expiring data set for cases where IBM support people have 
to work for several days on a problem and the customer doesn't like to grant LOGON 
permission to a well known person all the time. 

In this case, the expiring data set must be renamed to "something" and the none expiring data 
set must be renamed to the original expiring data set name. 


This is an example of how the permission data set might look like. 


LOGON 

ONTOPSW 

at 

25 

Feb 

1998 

17:45:01 

LOGON 

ATS1234 

at 

26 

Feb 

1998 

13:00:09 

LOGON 

ONTOPSW 

at 

26 

Feb 

1998 

16:30:17 

LOGON 

ONTOPSW 

at 

27 

Feb 

1998 

09:05:33 
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21.2 Qualifier EXEC TOPQUAL 


/*REXX* 
/* 

/* 


'ONTOP' 

IBM TECHNISCHER AUSSENDIENST 


LEVEL: V7R3M3 


PROGRAM NAME: 


TOPQUAL 


Hinweis: Please change ont_main and top_pref according to your 
installation. 

ont_main is the ONTOP maintenance Userid 
ont_user is the prefix for the ONTOP data sets. 

It can be the maintenance userid or a dedicated 
high level qualifier like ONTOP. 


/* CHANGE HISTORY: 

/* 

/* NAME: DATE: 

/* HHD 02/12/98 

/* HHD 06/29/01 

/* 

/**********************, 
Trace 'o' 

parse arg get_qual . 


DESCRIPTION: 
add ont_main 
change ont_user 


to top_pref 


JUST FOR TRACING 
what is requested ? 


own_user = USERID() 
ont_main = ONTOP00 
top_pref = ONTOP 

/* can be changed, but shouldn't - 

ont_prof = ""own_user".ONTOP.ISPPROF" 
ont_pref = ""top_pref".V7R3M3" 

/* can be changed, but shouldn't - 


own USERID 
maintenance userid 
prefix 


ONTOP PROFILE 

ONTOP data set prefix 


SELECT 

WHEN get_qual 
ret_qual 
WHEN get_qual 
ret_qual 
WHEN get_qual 


OTHERWISE 


'ont_pref' then 
ont_pref 
'ont_prof' then 
ont_prof 
'ont_main' then 
ont_main 


check request 
pref was requested 

prof was requested 

main was requested 


'OTHERWISE' 


Exit ret_qual 


pass back qualifier 


ONTOP Qualifiers 

Action 

• If you run with all the defaults nothing has to be changed, defaults are: 

- ont_main = ONTOPOO 

- top_pref = ONTOP 

Note 

As ont_main and top_pref have to be set only during initial installation, this EXEC is not 
available under customization. 
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21.3 TOPPROI ONTOP House Keeping EXEC 


/*REXX* 

/* 

/* 

/* - 

/ 

/ 

/ 

/* 

/* . 

/* . 

/* . 

I -k -k -k -k 

Trace 


' ONTOP' 

IBM TECHNISCHER AUSSENDIENST 


LEVEL: V7R3M3 


PROGRAM NAME: 


TOPPROI 


/* JUST FOR TRACING 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


/* - */ 

/* SUBROUTINE to create ONTOP Profile (only if not around) */ 

/* - */ 

proi_prof: /* */ 

status = msg('OFF') /* suppress messages */ 

ont_ispp = " "'ont_prof"(TOPPROF) '" /* TOPPROF on ISPPROF */ 

top_prof = "'"ont_prof"'" /* it does need hyphens */ 

"FREE FI(ISPPROF)" /* free previous allocs */ 

If SYSDSN(top_prof) = OK then Do /* profile is around */ 

"ALLOC F(ISPPROF) DA("top_prof") SHR REUS"/* ALLOC ISPF PROFILE */ 

End /* */ 

Else Do /* profile is not around */ 

"ALLOC FILE(ISPPROF), /* allocate new one */ 

DA("top_prof") NEW CATALOG, /* */ 

RECFM(F B) LRECL(80) , /* */ 

BLKSIZE(6160) DSORG(PO), /* */ 

SP(8,5) TRACKS DIR(99)" /* */ 

if rc A = 0 then signal out_01 /* go to error exit */ 

End /* */ 

status = msg('ON') /* */ 

Return /* */ 


ONTOP Profile allocation 


Action 

• STORCLAS, MGMTCLAS, DATACLAS may be used 

TOPPROI is the ONTOP house keeping EXEC. 

Each time ONTOP is started, it establishes the ONTOP environment. 

It checks if the ONTOP profile is available and if not, a new profile is allocated and all the 
relevant members are copied from TOPCNTL 
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21.4 TOPIPCSA ONTOP IPCS Allocation EXEC 


/*REXX* ****************************************** 
/* 'ONTOP' 

/* IBM TECHNISCHER AUSSENDIENST 

/* - 

/* LEVEL: V7R3M3 

/* - 

/* PROGRAM NAME: TOPIPCSA 

/* . 

/************************************************ 
TRACE 'O' / 

/ 

/ 

Exit / 

/* - 

/* ALLOC IPCS VSAM CLUSTER (DUMP DIRECTORY) 

/* - 

ipcsa_ddir: / 



JUST FOR TRACING 

go back to TOPIPCS 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


ELSE DO /^DIRECTORY NOT AROUND*/ 


"DEFINE CLUSTER(NAME("ONT_DIR") INDEXED, 

/* 

DEF NEW DIRECTORY 

*/ 

REUSE SHAREOPTIONS(1,3)), 

/* 


*/ 

INDEX(NAME("ONT_IND") TRACKS(15,15), 

/* 


*/ 

CONTROLINTERVALSIZE(4096) ) , 

/* 


*/ 

DATA(NAME("ONT_DAT") CYLINDERS(50,50), 

/* 


*/ 

KEYS(128 0) RECORDSIZE(384 3072))" 

/* 


*/ 

"IPCSDDIR "ONT_DIR"" 

/* 

SET IPCS DDIR NAME 

*/ 

"ALLOC FI(IPCSDDIR) DA("ONT_DIR") OLD REUSE" 

/* 

ALLOC NEW DDIR 

*/ 

if rc A = 0 then signal out_01 

/* 

go to error exit 

*/ 

END 

/* 


*/ 

status = msg('ON') 

/* 

turn MSG on again 

*/ 

Return 

/* 


*/ 

/*- 

— 


-*/ 

/* ALLOC IPCS PRINT DATASET (DD=IPCSPRNT) 



*/ 

/*- 

— 


-*/ 

ipcsa_prnt: 

/* 


*/ 

ELSE DO 

/* 

prnt DS not around 

*/ 

"ALLOC FILE(IPCSPRNT), 

/* 

alloc new prnt DS 

*/ 

DA("ONT_PRT") NEW CATALOG, 

/* 


*/ 

RECFM (V B A) LRECL(137), 

/* 


*/ 

BLKSIZE(13704) DSORG(PS), 

/* 


*/ 

SPACE(10,1) CYLINDERS" 

/* 


*/ 

if rc A = 0 then signal out_01 

/* 

go to error exit 

*/ 

END 

/* 


*/ 

status = msg('OFF') 

/* 

turn MSG on again 

*/ 

Return 

/* 


*/ 

/*- 

— 


-*/ 

/* ALLOC IPCS TOC DATASET (DD=IPCSTOC) 



*/ 

/*- 

— 


-*/ 

ipcsa_toc: 

/* 


*/ 

ELSE DO 

/* 

toe DS not around 

*/ 

"ALLOC FILE(ipsctoc) , 

/* 

ALLOC NEW TOC DS 

*/ 

DA("ONT_TOC") NEW CATALOG, 

/* 


*/ 

RECFM (V B A) LRECL(137), 

/* 


*/ 

BLKSIZE(13704) DSORG(PS), 

/* 


*/ 

SPACE(10,1) CYLINDERS" 

/* 


*/ 

if rc A = 0 then signal out_01 

/* 

go to error exit 

*/ 

END 

/* 


*/ 

status = msg('ON') 

/* 

turn msg on again 

*/ 

Return 

/* 


*/ 


IPCS allocation EXEC 


Action 

• STORCLAS, MGMTCLAS, DATACLAS may be used 

• VOLUME(name) may be needed for "DEFINE CLUSTER" 
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22. ONTOP Customization 

After having adapted the control files and inspected the execs, it is now possible to do the 
ONTOP guided customization. The customization is only allowed to the maintenance userid 
set in EXEC TOPQUAL (default is ONTOPOO). 

During customization EDIT is used to update the appropriate ONTOP control files, EXECs 
and Panels 


******************************************************************** 'k'k'k'k'k'k'k'k'k'k'k 

* CUSTOMER NAME HHD ON TEST * 

******************************************************************************* 

* ONTOP Customization Panel * 

******************************************************************************* 

please select ===> 

1 CUSNAM - customize customer name 

2 TOPBRO - customize Browse data sets 

3 TOPALLOW - customize allow control member 

4 TOPENVTO - customize environment control table 

5 TOPENVnn - customize allocation control tables 

6 TOPHOME - customize ONTOP Home Panel 

7 JOBCARD - customize the jobcard 

8 TOPUSER - customize ONTOP Userids 

9 TOPSDSF - customize ONTOP interface to SDSF 

A TOPIFX - customize ONTOP interface to IFX 

B TOPCMDS - customize ONTOP command tables 

C - not used yet 

D TOPPW - Resume Passwords for ONTOP Userids 

Press PF3 to return to previous Panel PF1 HELP 


This is the ONTOP Customization Panel. 

Selecting option "0" at the ONTOP Home Panel brings up the customization panel. 
All the subsequent customization activities will be discussed on the following pages. 


if used 

if used 

if used 
if used 
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22.1 Customize Customer Name 


** CUSNAM ************************************************** 

* THIS IS WHERE THE CUSTOMER NAME SHOULD GO * 


02/04/98 


customer 


CUSNAM - customer name control file 


Actions 

• Replace customer with the name of your company 

(It is displayed in the header line of every ONTOP panel) 


22.2 Customize Browse Data Sets 


TABBRO 


* LIST OFF ALL AVAILABLE BROWSE DATASETS 


01/29/98 * 


ONTOP 

SYS1.PARMLIB 
userid.ONTOP 
UNDEFINED 
UNDEFINED 


TOPBRO Browse data set control table 


Actions 

• fill in the data sets allowed for browsing 

(Those data sets are available under option 1 at the ONTOP Home Panel) 
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22.3 Customize the LOGON permission member TOPALLOW 

TOPOOOIO 
TOP00020 
TOP00020 
TOP00020 
TOP00020 
TOP00040 
TOP00050 
TOP00060 
TOP00070 


TOPALLOW control member 

Actions 

• Put in permission data set name and telephone number of operations 
(This info will be used by EXEC TOPALLOW) 

Attention: This step is only needed, if a permission data set is used. 


* TOPALLOW ********************************************** 

PLEASE ADJUST DATA SET NAME AND OPERATOR TELEFON NUMBER* 
FIRST NON COMMENT ROW = DATA SET NAME * 

SECOND NON COMMENT ROW = TELEPHONE NUMBER * 

02/04/98 * 


ONTOP.START.ERLAUBT 
01234-12-1234 
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22.4 Customize Dump Environment Control Table 


* * TOPENVT0*********************************************************** 

* DUMP ENVIRONMENT SELECTION TABLE * 


* HINWEIS: ASTERISK IN COLUMN 1 MEANS COMMENT. 

* A NEW ENVIRONMENT SHOULD ALWAYS BE PLACED AT THE END 

* OF THE TABLE. 

* THE ASTERISK UNDER COLUMN "F" SHOULD NOT BE MOVED AND 

* ALWAYS POINT TO THE BRINGUP ENVIRONMENT. 

* UNUSED FIELDS MUST BE PADDED BY DASHES (-) 


* BY DEFAULT, THERE ARE 3 ENVIRONMENTS AVAILABLE. * 

* ENVIRONMENT 1 IS THE BRINGUP ENVIRONMENT JUST USING THE ONTOP, * 

* ISPF AND IPCS LIBRARIES. THIS IS TO MAKE SURE ONTOP CAN ALWAYS * 

* BE STARTED. PLEASE MODIFY THE USED DATA SETS IN TABLE TOPENVOl * 

* TO REFLECT THE DATA SETS ON YOUR SYSTEM. * 

* ENVIRONMENT 2 IS AN EXAMPLE AND SHOULD BE MODIFIED ACCORDING * 

* THE PRODUCT LEVELS INSTALLED ON THE SYSTEM. IN TABLE TOPENV02 * 

* YOU MUST CHANGE THE DEFAULT DATA SETS AND ADD THE PRODUCT * 

* DATA SETS. * 

* ALL THE OTHER ENVIRONMENT'S, UP TO 99, CAN BE USED FOR ALL KIND * 

* OF DIFFERENT ANALYZING SCENARIOS. * 

* THE PREDEFINED TABLE TOPENV03 SHOULD BE CHECKED AND EVEN IF NOT * 

* USED MODIFIED ACCORDING TO THE SYSTEM ENVIRONMENT. * 


* AFTER FINISHING WITH THIS TABLE AND ALL THE DATA SET CONTROL 

* TABLES TOPENVOl - TOPENVNN, PLEASE USE ONTOP OPTION 3 AND 

* SWITCH OVER ALL ENVIRONMENTS, TO MAKE SURE YOU DID NOT ADD 

* INVALID DATA SETS. 


/390 ! 

IMS 

! CICS! 

DB2 

! JES2! 

VTAM!TCPIP! 

MQS 

! COMMENT 

! F ! S 

TOP ! 

TOP 

! TOP ! 

TOP 

! TOP ! 

TOP ! TOP ! 

TOP 

! BRINGUP 

! * ! 01 

703 ! 

? ? ? 

! ? ? ? ! 

? ? ? 

! ? ? ? ! 

??? ! ??? ! 

? ? ? 

! /390 2.10 

! - ! 02 

-! 

— 

!-! 

— 

!-! 

-j-j 

— 

! FREE 

! - ! 03 


Dump environment control table TOPENVTO 

Actions 

• Fill in all the level of the environments you are running on your system 

The member shown above is the initial ONTOP member, assuming OS/390 2.10. 

Now the customer must fill in all the product levels for each environment used. 

Each row is representing a dedicated dump environment identified by the suffix in the last 
column and for each suffix there must be an allocation control table (TOPENVnn). 

Please do not use environment (1) for production. 

Attention: Even if only one dump environment (2) is used, TOPENVOl and TOPENV03 
must be customized in the next step !!! 

TOPENVTO changes only become active after LOGOFF/LOGON, or switching the dump 
environment. 
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22.5 Customize Allocation Control Tables TOPENVOI-nn 





* CUSTOMER NAME CUSTOMER * 

•k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

* ONTOP Customization Panel * 

******************************************************************************* 


please select ===> 5 


Press 

V_ 


+-+ 


1 

CUSNAM 

- customize 

customer name 


- Row 1 to 3 of 3 

2 

TOPBRO 

- customize 

Browse data sets 


Select one member 

3 

TOPALLOW 

- customize 

allow control mem 



4 

TOPENVTO 

- customize 

environment contr 


! Control Member ! 

5 

TOPENVnn 

- customize 

allocation contro 



6 

TOPHOME 

- customize 

ONTOP Home Panel 


! TOPENVO1 ! 

7 

JOBCARD 

- customize 

the jobcard for S 


_ ! TOPENV02 ! 

8 

TOPUSER 

- customize 

ONTOP Userids 

i 

! TOPENV03 ! 

9 

TOPSDSF 

- customize 

ONTOP interface t 


** Bottom of data *** 

A 

TOPIFX 

- customize 

ONTOP interface t 



B 

TOPCMDS 

- customize 

ONTOP command tab 



c 


- not used yet 

i 

Command ==> 

D 

TOPPW 

- Resume Passwords for ONTOP 

+- 


PF3 

to return 

to previous Panel PF1 HELP 




J 


Allocation control member selection POPJUP. 

As there can be lots of allocation control members there is a POP_UP to let the user choose 
the member to be modified. 

The member selected will be edited and the user can change it. 

Attention: All 3 members delivered by ONTOP must be checked and corrected ! 
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**TOPENV02************************************************************** 

* DATA SET ALLOCATION CONTROL TABLE * 

* HINWEIS: ASTERISK IN COLUMN ONE MEANS COMMENT * 

* THE FOLLOWING PRODUCT LEVELS WILL BE COVERED BY THIS TABLE: * 

* - PROD1 * 

* - PROD2 * 

* - PRODN * 


* 

/* 



*/ 

* ISPCLIB 

/* 

CLISTS/REXX 

*/ 

ONTOP.V7R3M3.ISPCLIB 

/* 

ONTOP 

CLISTS 

*/ 

ISP.SISPCLIB 

/* 

ISPF 

CLISTS 

*/ 

SYS1.SBLSCLIO 

/* 

IPCS 

CLISTS 

*/ 

* 

/* 



*/ 

* ISPPLIB 

/* 

PANEL 

LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPPLIB 

/* 

ONTOP 

PANELS 

*/ 

ISP.SISPPENU 

/* 

ISPF 

PANELS 

*/ 

SYS1.SBLSPNLO 

/* 

IPCS 

PANELS 

*/ 

* 

/* 



*/ 

* ISPMLIB 

/* 

MESSAGE LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPMLIB 

/* 

ONTOP 

MESSAGES 

*/ 

ISP.SISPMENU 

/* 

ISPF 

MESSAGES 

*/ 

SYS1.SBLSMSGO 

/* 

IPCS 

MESSAGES 

*/ 

* 

/* 



*/ 

* ISPSLIB 

/* 

SKELETON LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPSLIB 

/* 

ONTOP 

SKELETONS 

*/ 

ISP.SISPSENU 

/* 

ISPF 

SKELETONS 

*/ 

ISP.SISPSLIB 

/* 

ISPF 

SKELETONS 

*/ 

SYS1.SBLSKELO 

/* 

IPCS 

SKELETONS 

*/ 

* 

/* 



*/ 

* ISPTLIB 

/* 

TABLE 

INPUT LIBRARIES 

*/ 

ONTOP.V7R3M3.ISPTLIB 

/* 

ONTOP 

TABLES 

*/ 

ISP.SISPTENU 

/* 

ISPF 

TABLES 

*/ 

SYS1.SBLSTBLO 

/* 

IPCS 

TABLES 

*/ 

* 

/* 



*/ 

* IPCSPARM 

/* 

IPCS i 

CONTROL MEMBER 

*/ 

SYS1.PARMLIB 

/* 

MVS PARMLIB 

*/ 

* 

/* 



*/ 

* TSOLIB 

/* 

LOAD ] 

MODULES 

*/ 

SYS1.MIGLIB 

/* 

IPCS ] 

MODULES 

*/ 

ONTOP.V7R3M3.TOPTERS 

/* 

TRSMAIN LIB 

*/ 

* 

/* 



*/ 

* END 

/* 



*/ 


Example of data set allocation control table 


Actions 

• Fill in all the data set names matching your environment 


• ISPCLIB -> 

• ISPPLIB -> 

• ISPMLIB -> 

• ISPSLIB -> 

• ISPTLIB -> 

• IPCSPARM -> 

• TSOLIB -> 


CLISTS/EXECs 

Panels 

Messages 

Skeletons 

Tables 

PARMLIBS 

Programs/Modules 


Note 

PARMLIB, MIGLIB, SBLSlibs must match the environment set in the environment control 

table (e.g. HBB7703). Don't forget to add the product data sets (IMS, CICS, DB2,.) 

See examples under "Examples of Control Tables" and the IPCS part in this documentation 
for IPCS component handling. 
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22.6 Customization of ONTOP Home Panel TOPHOME 


) ATTR 

A TYPE(OUTPUT) 
0 TYPE(input) 

{ TYPE(input) 

§ TYPE(TEXT) 

# TYPE(TEXT) 


COLOR(YELLOW) 
COLOR(white) 
COLOR(white) 
COLOR(GREEN) 
COLOR(TURQ) 


** Top of Data 

INTENS(HIGH) 
INTENS(HIGH) 
INTENS(non) 
INTENS(LOW) 
INTENS(LOW) 


CAPS(OFF) 
CAPS(ON) 
CAPS(OFF) 
CAPS(OFF) 
CAPS(OFF) 


PAD 

PAD 

PAD 

PAD 

PAD 


SKIP(ON) 
SKIP(ON) 


)BODY smsg(da2msg) lmsg(da2msg) 


*% CUSTOMER NAME &CUSTNAME 


+ *% 


ONTOP Home Panel 


V7R3M3 - HHD +* 


+please select ===>_OPT + 


0 +CUSTOMIZE 

1 +BROWSE 

2 +EDIT 

3 +IPCS 

4 +EREP 

5 +IND$FILE 

6 + 

7 + 

8 + 

9 +TERSE 
A +SDSF 
B +ISPF 


- CUSTOMIZE ONTOP 

- BROWSE on System-/Problem-Data 

- EDIT on Userid Data 

- Start IPCS 

- not active 

- PC Up and Down 

- not defined yet 

- not defined yet 

- not defined yet 

- TERSE a Dataset for Upload to IBM 

- SDSF 

- ISPF - Standard 


+USERID 

+Proc 


&ZUSER 
&ZLOGON 


+ Press%PF3 +to Terminate ONTOP 
A da2msg § 

) INIT 

&DAT = '&ZDAY..&ZMONTH..&ZYEAR' 
&ZPRIM = YES 
vget (relo) 
if (&relo = ' Y' ) 

&opt = 3 
.resp = ENTER 
.HELP = Thphome 
)REINIT 
&opt = ' ' 

.resp = ' ' 

) PROC 

&relo = 'N' 


&OPT1 = TRUNC (&OPT,'.') 

/* VER (&OPTl,LIST,0,1,2,3,4,5,6,7,8,9,A,B,MSG=KDMSG028) 
VER (&OPT1,LIST,0,1,2,3,5,9,A,B,MSG=KDMSG028) 

VER (&OPT1,NONBLANK,MSG=KDMSG02 9) 

&YLOGOFF = TRUNC (&OPT,'.') 

&SEL = TRANS( TRUNC (&OPT,'.') 

0, 1 cmd(%TOPCUST)' 

1, 'CMD(%TOPBRO)' 

2, 'CMD(%TOPTALIS)' 


/* 

/* 

/* 

/* 

/* 

/* 


remove newappl/passlib for ipcs print 
3,'CMD(%TOPIPCS) newappl(BLSG) 

3, 'CMD(%TOPIPCS)' 

4, 'PANEL(TOPEREPO)' 

5, 'PGM(ISRPTC) SCRNAME(CMD)' 

6, 'CMD(%TOPDA2) NEWAPPL(DA2) 

7, 'CMD(%TOPIFX) NEWAPPL(PFTS) 

8, 'cmd(%TOPSPLIT)' 

9, 'CMD(%TOPTERSE)' 

A, 'cmd(%topsdsf) newappl(ISF) 

B, 'panel(isr§prim)' 


business 

PASSLIB' 


PASSLIB' 

PASSLIB' 


passlib' 


/* 


X, 'EXIT 

Y, 'EXIT 

) END 


*/ 

*/ 

*/ 


*/ 

*/ 

*/ 


*/ 


Panel coding of TOPHOME. 

Actions 

• add, or delete functions 
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22.7 Customize JOBCARD for Split 


* * JOBCARD *********************************************** 

* THIS IS THE JOBCARD FOR SPLIT * 


* 03/01/00 

//ADAM3S JOB (7949),MSGLEVEL=(1,1),MSGCLASS=X,CLASS=A 


Jobcard for data set split 

Actions 

• Change the jobcard according to your system 

Attention: This step needs only to be performed, if the split function is used. 
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22.8 Customize ONTOP work userids 

** TOPUSER *********************************************** 
* 05/04/01 * 


* THIS IS WHERE THE ONTOP WORK USERIDS SHOULD GO * 

k k 

* THERE SHOULD BE AT LEAST 3 ONTOP WORK USERIDS ! * 

k k 


* ATTENTION: DO NOT CHANGE THE PICK DATE DATA MANUALLY. * 

* ONLY PROGRAM TOPPW IS ALLOWED TO UPDATE * 

* THIS DATA. * 

* PICK DATE IS STORED LIKE: * 

* FIRST TWO DIGITS = YEAR * 

* LAST THREE DIGITS = JULIAN DAY. * 

k k 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

* USERID ! PICK DATE 

* - + - 

ONTOPOl 01200 

ONTOP02 01200 

ONTOP03 01200 

List of work User used by ONTOP 


Actions 

• Change the Userids according to your system. 

If you add users, just copy the last entry and modify the userid. 

Attention: Do not mess with the pick date !!! 
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22.9 Customize ONTOP Interface to SDSF 


/*REXX* 


/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 


'ONTOP' 

IBM TECHNISCHER AUSSENDIENST 


LEVEL: V7R3M3 

PROGRAM NAME: 

TOPSDSF 


PROGRAM LANGUAGE: 

REXX 


PROGRAM AUTHOR: 

HHD 


DATE WRITTEN: 

07/12/97 


PROGRAM DESCRIPTION: 

START EXEC OF SDSF 

DOES THE ALLOCS/LIBDEFS FOR 

SDSF 

CALLED BY: 

NOBODY 


IT CALLS: 

XXXXXXXXXX - SDSF HOME 

PANEL 

PARAMETERS PASSED: 

NONE 



CHANGE HISTORY: 

NAME: DATE: DESCRIPTION: 


TRACE '0' 

DSFHLQ = 'ISF' 


DSF_PROC 

DSF_PANS 

DSF_MSGS 

DSF_TLIB 


' "DSFHLQ".SISFEXEC 1 " 
' "DSFHLQ".SISFPLIB 1 " 
' "DSFHLQ".SISFMLIB 1 " 
' "DSFHLQ".SISFTLIB 1 " 


"ALLOC F(DSFPROC) DA("DSF_PROC") SHR" 
"ALLOC F(DSFPANS) DA("DSF_PANS") SHR" 
"ALLOC F(DSFMSGS) DA("DSF_MSGS") SHR" 
"ALLOC F(DSFTLIB) DA("DSF_TLIB") SHR" 


"ALTLIB ACT APPLICATION(CLIST) F{"DSFPROC")" 


ADDRESS ISPEXEC 

"LIBDEF ISPPLIB LIBRARY 
"LIBDEF ISPMLIB LIBRARY 
"LIBDEF ISPTLIB LIBRARY 


ID(DSFPANS)" 
ID(DSFMSGS)" 
ID(DSFTLIB)" 


"SELECT PANEL(ZSDSFOP2) NEWAPPL(ISF) , 
PASSLIB" 


"LIBDEF ISPPLIB" 
"LIBDEF ISPMLIB" 
"LIBDEF ISPTLIB" 


ADDRESS TSO 

"ALTLIB DEACTIVATE APPLICATION(*)" 

"FREE F(DSFPROC DSFPANS DSFMSGS DSFTLIB) 
EXIT 


/* JUST FOR TRACING 
/* 

/* SDSF PREFIX 
/* 

/* SDSF CLISTS 
/* SDSF PANELS 
/* SDSF MESSAGES 
/* SDSF TABLE 
/* 

/* ALLOC SDSF EXECS 
/* ALLOC SDSF PANELS 
/* ALLOC SDSF MESSAGES 
/* ALLOC SDSF TABLES 
/* 

/* ALTLIB TO SDSF 
/* 

/* TELL REXX ABOUT ISPF 
/* USE LIBDEF FOR PANELS 

/* USE LIBDEF FOR MSGS 

/* USE LIBDEF FOR TUBS 

/* 

/* GO ON WITH SDSF 
/* 

/* 

/* USE LIBDEF FOR PANELS 

/* USE LIBDEF FOR MSGS 

/* USE LIBDEFS FOR SKELS 
/* 

/* TELL REXX ABOUT TSO 
/* RESET APPL CLIST 
/* FREE LIBDEF DD NAMES 
/* OK. THAT'S IT || 


/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 


Interface Exec to SDSF. 


Actions 

• Check for data set correctness 

Note 

If JES2 is not installed, the SDSF option should be removed from panel TOPHOME. 
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22.10 Customize ONTOP Interface to IFX 


/*REXX* 


/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 


' ONTOP ’ 


IBM 

TECHNISCHER 

AUSSENDTENST 


LEVEL: V7R3M3 

PROGRAM NAME: 

TOPIFX 



PROGRAM LANGUAGE: 

REXX 



PROGRAM AUTHOR: 

HHD 



DATE WRITTEN: 

07/12/97 



PROGRAM DESCRIPTION 

: START EXEC OF IFX 

DOES THE ALLOCS/LIBDEFS 

FOR IFX 

CALLED BY: 

TOPHOME 

- ONTOP 

HOME PANEL 

IT CALLS: 

PFTNP10 

- IFX NON-RJE PANEL 

PARAMETERS PASSED: 

NONE 




CHANGE HISTORY: 
NAME: DATE : 


DESCRIPTION: 


TRACE 'O' /* 

PFTHLQ = 'PFT3100' /* 

/* 

PFT_PROC = "'"PFTHLQ" .PFTCLIB"' /* 

PFT_PANS = "PFTHLQ" .PFTPLIB"' /* 

PFT_MSGS = "'"PFTHLQ".PFTMLIB'" /* 

PFT_PARM = " '"PFTHLQ" .HHDUSAM"' /* 

/* 

"ALLOC F(PFTPROC) DA("PFT_PROC") SHR" /* 

"ALLOC F(PFTPANS) DA("PFT_PANS") SHR" /* 

"ALLOC F(PFTMSGS) DA("PFT_MSGS") SHR" /* 

"ALLOC F(FTSPARM) DA("PFT_PARM") SHR" /* 

/* 

"ALTLIB ACT APPLICATION(CLIST) F(PFTPROC)" /* 

/* 

ADDRESS ISPEXEC /* 

"LIBDEF ISPPLIB LIBRARY ID(PFTPANS)" /* 

"LIBDEF ISPMLIB LIBRARY ID(PFTMSGS)" /* 

/* 

"SELECT PANEL(PFTNP10) NEWAPPL(PFT), /* 

PASSLIB" /* 

/* 

"LIBDEF ISPPLIB" /* 

"LIBDEF ISPMLIB" /* 

/* 

ADDRESS TSO /* 

"ALTLIB DEACTIVATE APPLICATION(*)" /* 

"FREE F{PFTPROC PFTPANS PFTMSGS FTSPARM)" /* 

/* 

EXIT /* 


JUST FOR TRACING 
TEST IFX HLQ 

PFT CLISTS 
PFT PANELS 
PFT MESSAGES 
PFT CONTROL DATA 

ALLOC TO DD PFTPROC 
ALLOC TO DD PFTPANS 
ALLOC TO DD PFTMSGS 
ALLOC TO DD FTSPARM 

DO ALTLIB TO PFT 

TELL REXX ABOUT ISPF 
LIBDEFS FOR PANELS 
LIBDEFS FOR MSGS 

GO ON WITH IFX 


CLEAR ISPMLIB ALLOCS 
CLEAR ISPMLIB ALLOCS 

TELL REXX ABOUT TSO 
RESET APPL CLIST 
FREE LIBDEF DD NAMES 

OK. THAT'S IT || 


/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 


Interface Exec to IFX 


Actions 

• Check for data set correctness 

Note 

This goes only along with the IFX Enduser Interface shipped for the NJE environment. 
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22.11 Customization of ONTOP Command Tables 


r 




Command ===> 


Command Table Utility 


Specifications 
Application ID . . TOP 

Enter "/" to select option 
Show description field 


Command search order 
Application table : TOP 
User table . . . . : 

Site table . . . . : 

System table . . . : ISP 


If no application ID is specified, the current application ID will b 
used. The name of the command table to be processed is formed by 
prefixing the application id to the string 'CMDS'. For example: 
Application ID . . TST results in a command table name of 'TSTCMDS 


Fl=Help F3=Exit F12=Cancel 


Press PF3 to return to previous Panel PF1 HELP 



ISPF command table selection POP_UP 


Actions 

• Fill in the prefixes used by ONTOP as APPLICATION ID 
-TOP 
- BLSG 


56 


TSO/ONTOP Inst/Cust/Usage Guide 


17.10.01 














A ONTOP 


22.12 ISPF Command Table Modification Panel for TOPCMDS 



Menu Utilities Help 


Command ===> 


Display TOPCMDS 


Row 1 to 1 of 1 
Scroll ===> PAGE 


The command table is currently open, it cannot be modified. Use the view(V) 
row command to see an entire entry. 


Verb 

NON 


T Action 
0 NOP 

**************** Bottom of data ******************************* 


Fl=Help F3=Exit F10=Actions F12=Cancel 



Example of ISPF 3.9 command table handling. 


This is the ISPF command table modification panel for TOPCMDS, the ONTOP command 
table. 

Actions 

• Add or delete functions 


As TOPCMDS is active during Logon of the ONTOP Userid it only can be viewed but not 
changed. To be able to change it, you must go to EXEC TOPSTART, and change TOP to 
XXX then LOGOFF and start again. After having done the modification switch back XXX to 
TOP, so the changes can become active at the next LOGON. 

There is a comment line in TOPSTART as well as in LIBSTART for switching between TOP 
and XXX. 
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22.13 ISPF Command Table Modification Panel for BLSGCMDS 


File Menu Utilities Help 


ISPUCMD Update BLSGCMDS Row 1 to 13 of 13 

Command ===> Scroll ===> PAGE 

Insert (I), delete (D), repeat (R) and edit (E) command entries. 

Enter END command to save changes or CANCEL to end without saving. 


Verb 

T 

Action 




IPCS 

2 

SELECT 

PGM(BLSGSCMD) 

PARM(&ZPARM) 


OHELP_ 

2 

SELECT 

CMD(%TOPIPTUT 

HLP('&ZPARM. 

’) ) 

RFIND 

0 

PASSTHRU 



DSNP 

2 

SELECT 

PGM(BLSGSCMD) 

PARM(%TOPIPDSN) 


TITLE 

2 

SELECT 

PGM(BLSGSCMD) 

PARM(%TOPIPTIT) 


DEBUG 

0 

SELECT 

PGM(BLSGSCMD) 

PARM(%TOPDEBUG 

&ZPARM) 

INDEX 

2 

SELECT 

PGM(BLSGSCMD) 

PARM(%TOPIPINX 

&ZPARM) 

SYSDSCAN 

4 

SELECT 

PGM(BLSGSCMD) 

PARM(%TOPIPSYS 

&ZPARM) 

MAINT 

0 

SELECT 

PGM(BLSGSCMD) 

PARM(%TOPIPMNT) 


RETRIEVE 

0 

RETRIEVE 



HHDTST 

0 

SELECT 

PGM(BLSGSCMD) 

PARM(%HHDTST) 


TSTHHD6 

0 

SELECT 

CMD(%TSTHHD6) 



TOPPRNT 

0 

SELECT 

CMD(%TOPPRNT) 



*************************** Bottom 

of data ******* 

******* 

: Help 

F3= 

=Exit 

F10=Actions 

F12=Cancel 




Example of ISPF 3.9 command table handling. 

This is the ISPF command table modification panel for BLSGCMDS, the IPCS command 
table 

Actions 

• Add or delete functions 


This is the end of initial ONTOP customization. Now some very short and simple function 
test should be performed. 
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23. ONTOP function test 

23.1 Test ONTOP dump environment switching 




Example of switching the dump environment 

Actions 

• Out of the ONTOP Home Panel select option “3” IPCS. 
This performs the sequence shown above 
Please test all available environments. 
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23.2 Test ONTOP userid/password management 



* CUSTOMER NAME CUSTOMER 


* ONTOP Customization Panel * 

please select ===> 


1 

CUSNAM 

- customize 

customer name 



2 

TOPBRO 

- customize 

Browse data sets 



3 

TOPALLOW 

- customize 

allow control member 

if 

used 

4 

TOPENVTO 

- customize 

environment control table 



5 

TOPENVnn 

- customize 

allocation control tables 



6 

TOPHOME 

- customize 

ONTOP Home Panel 



7 

JOBCARD 

- customize 

the jobcard 

if 

used 

8 

TOPUSER 

- customize 

ONTOP Userids 



9 

TOPSDSF 

- customize 

ONTOP interface to SDSF 

if 

used 

A 

TOPIFX 

- customize 

ONTOP interface to IFX 

if 

used 

B 

TOPCMDS 

- customize 

ONTOP command tables 



C 


- not used ; 

yet 



D 

TOPPW 

- Resume Passwords for ONTOP Userids 
+- 


-+ 


Press PF3 to return to ! Userid ONTOPOl is ready for ONTOP usage ! 

+-+ 


Example of TOPPW action. 

If customer is following the IBM suggested Userid/Password management, he can use this 
function to maintain the ONTOP work userids. 

Actions 

• From the ONTOP Home Panel go to CUSTOMIZE, select option “D” and wait for 
ONTOP to return the next available userid. (See example above) 
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24. Important message to the customer 

The efficiency of ONTOP/OS390 is directly bound to it’s usability. 

Only an ONTOP/OS390 optimal maintained and perfectly adapted to the customer 
environment can provide the best efficiency possible in an unforeseen problem situation. 
Therefore the following rules should be followed when using ONTOP/OS390: 

1. Keep ONTOP logon procedure and the control tables up to date 

• Keep TOPLOG up to date 

• Keep TOPENVTO up to date 

• Keep TOPENVnn up to date 

• Keep TOPSDSF up to date 

• Keep IPCS members on PARMLIB and related product LIBS up to date 

2. Do not migrate ONTOP data sets 

Make sure ONTOP userid data sets which are needed during logon are no candidates for 
migration, especially not to Tape. This is causing long delays during logon, especially if 
the user is prompted to replay if the recall is really needed. If migration of Dump and 
Trace data sets can not be prevented please use a media which can be restored in a 
reasonable time frame. Also do not specify a short time frame for migration actions e.g. 
DAILY. 

3. Give a region size of 256 MB to ONTOP userids 

Make sure ONTOP users are allowed to run with a TSO region size of 256 MB since 
dumps from large subsystems and images with large common storage areas, require large 
Ontop/IPCS user regions to format the 'complete' control block structure. Not doing so can 
cause significant delays in dump and trace analysis. 

4. Place ONTOP users in an optimized service class 

Make sure ONTOP users do get sufficient CPU service. ONTOP respective IPCS user do 
not behave like normal TSO user which are typically short term transactions. IPCS users 
are causing long running transactions by formatting large Control Block Chains or Trace 
Tables. If treaded like normal TSO users from an SRM or WLM perspective, the long 
mnning IPCS command, will cause the TSO address space rapidly being moved into 
Performance Period 2 or 3 and less service time is given to the user. 

This can again cause, not only frustration for the IPCS user, but cause significant delays in 
command execution as well major delays in problem analysis. 

5. ONTOP step up should be known to the customer 


EVERY SYSTEM CHANGE AFFECTING ONTOP 
SHOULD BE REPORTED TO THE ONTOP TEAM 
ONTOP@DE.IBM.COM 
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25. ONTOP EREP Tailoring 

ONTOP EREP Tailoring is only necessary, if this aid is used. Per default is this function not 
active. So the first step would be to EDIT panel TOPHOME and activate the EREP function 
under option 4. Then all the following subsequent actions must be performed. 

Note 

Since the EREP Module IFCEREP1 does not work without update authority on the logrec 
data set (even if only reporting is done) you have to give UPDATE access to the ONTOP 
userids. 

25.1 Start at TOPHOME 



ONTOP Homepanel 

Action 

• Select Option 4 EREP 


62 


TSO/ONTOP Inst/Cust/Usage Guide 


17.10.01 








A ONTOP 


25.2 Start Menu 



* CUSTOMER NAME HHD ON TEST * 


* EREP Start Menu * 

OPTION ===> 


1 

2 

EREP1 

EREP2 

- EREP Selection Menu 

- EREP Selection Menu 

1 

2 (Multi-LOGREC, FREE Format Report) 

3 

JOBOUT 

- Display Job Output, 

ISPF 

Opt. 3.8 

4 

JOBOUT 

- Display Job Output, 

SDSF 

required 

5 

6 

OUTPUT 

TAILOR 

- Display of EREP Results 

- Tailor EREP 



History data set (ACCIN) 


===> N (Yes=Y, No=N) Select System ===> SYS1 


Select record Type or 

'U' (all) 

===> u 

A 

ASYNC 

C CCH/CRW/SLH 

D 

DDR 

E 

EOD 

H MIH 

I 

IPL 

M 

MCH 

0 OBR 

S 

SOFTWARE 

T 

MDR 


Press PF3 to terminate and return to previous Panel PF1 HELP 

V_ ) 


EREP Start Panel 


Action 

• Select Option 6 EREP Tailoring 
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25.3 EREP Tailoring 



* KUNDENNAME HHD ON TEST * 

* EREP Tailoring * 

•k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

OPTION ===> _ 

1 - Define the ONTOP and EREP data set names 

2 - Define the System(s) to be serviced 

3 - Define the Prefix and VOLSER of System data sets 

4 - Define the execution parameters 

5 - Allocate EREP data sets 

SYSID ===> SYS1 The following Systems are defined: 

SYS1: SYS1 - MCEVS1 SYS7 : 

SYS2: SYS2 - MCEVS2 SYS8 : 

SYS3: - SYS9 : 

SYS4: - SYS10: 

SYS5: - SYS11: 

SYS6: - SYS12: 

Press PF3 to return to previous Panel 


V_ J 


EREP Tailoring for ONTOP 


Action 

• Please see online help 
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26. ONTOP Interface to customer environment 

There is a simple ONTOP interface to the customer environment. It can be called by using a 
command like: 

EX 'ONTOP.V7R3M3.ISPCLIB(LIBSTART)' 

The EXEC I2CUS on ONTOP ISPCLIB contains this command. It can be copied to a 
SYSPROC data set used by the customer. 

The I2CUS interface expects the customer environment to have allocated all the libraries 
needed for dump analysis. 

LIBSTART only adds the ONTOP libraries to the existing environment. 

There are 4 more EXECs and 1 Panel to get the customer interface running. 

Additional ONTOP code on ISPCLIB 

• LIBSTART -> Customer Interface EXEC 

• LIBHOME -> Start ONTOP application 

• LIBIPCS -> IPCS Start EXEC 

• LIB IPCS A -> IPCS alloc EXEC 

Additional ONTOP code on ISPPLIB 

• LIBHOME -> ONTOP Home Panel 

Advantages and Disadvantages of using the customer interface versus the ONTOP LOGON 
procedure. 

• Advantage 

- easy to implement 

- easy to maintain 

• Disadvantages 

- no isolated IBM environment 

- no dump environment switching 

- not possible to use one ONTOP installation in a Parallel-Sysplex 

Only the LIBSTART EXEC and the LIBHOME Panel will be discussed here, but it might be 
necessary to check the other 3 EXECs as well ? 

Conclusion 

I2CUS should only be used by customer but not by IBM. 
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26.1 ONTOP Customer Interface Start EXEC LIBSTART 


/*REXX* 

/* 

/* 

/*- 

r 

h 

/* 

/* 

/* 

/* 

/* 

/* NAME: DATE: 

/* 

/* 

/********************** 
TRACE '0' 

TOPHLQ = 'ONTOP.V7R3M3 1 


'ONTOP' 

IBM TECHNISCHER AUSSENDIENST 


LEVEL: V7R3M3 


Hinweis: change TOPHLQ if default is not used 


CHANGE HISTORY: 


DESCRIPTION: 


TOP_PROC 

TOP_PANS 

TOP_MSGS 
TOP_SKEL 


"TOPHLQ".ISPCLIB' 
"TOPHLQ".ISPPLIB' 


"TOPHLQ" 

"TOPHLQ" 


, ISPMLIB' 
, ISPSLIB' 


JUST FOR TRACING 

ONTOP prefix 

ONTOP EXECS 
ONTOP PANELS 
ONTOP MESSAGES 
ONTOP SKELETONS 


TOP_TLIB 

= "'"TOPHLQ". 

. ISPTLIB'" 



/* 

ONTOP 

TABLE 

INTPUT 

TOP_TABL 

= "'"TOPHLQ". 

. ISPTLIB'" 



/* 

/ * 

ONTOP 

TABLE 

OUTPUT 

"ALLOC 

F (TOPPROC) 

DA(' 

'TOP_ 

_PROC" ) 

SHR 

REUS" 

/* 

ALLOC 

TO 

DD 

TOPPROC 

"ALLOC 

F(TOPPANS) 

DA(' 

'TOP_ 

_PANS") 

SHR 

REUS" 

/* 

ALLOC 

TO 

DD 

TOPPANS 

"ALLOC 

F 

(TOPMSGS) 

DA(' 

'TOP_ 

_MSGS ") 

SHR 

REUS" 

/* 

ALLOC 

TO 

DD 

TOPMSGS 

"ALLOC 

F 

(TOPSKEL) 

DA(' 

'TOP_ 

_SKEL" ) 

SHR 

REUS" 

/* 

ALLOC 

TO 

DD 

TOPSKEL 

"ALLOC 

F 

(TOPTLIB) 

DA(' 

'TOP_ 

_TLIB" ) 

SHR 

REUS" 

/* 

ALLOC 

TO 

DD 

TOPTLIB 

"ALLOC 

F 

(TOPTABL) 

DA(' 

'TOP_ 

_TABL" ) 

SHR 

REUS" 

/* 

ALLOC 

TO 

DD 

TOPTABL 


"ALTLIB ACT APPLICATION(CLIST) F(TOPPROC)" 


ADDRESS ISPEXEC 

"LIBDEF ISPPLIB LIBRARY ID(TOPPANS) 
"LIBDEF ISPMLIB LIBRARY ID(TOPMSGS) 
"LIBDEF ISPSLIB LIBRARY ID(TOPSKEL) 
"LIBDEF ISPTLIB LIBRARY ID(TOPTLIB) 
"LIBDEF ISPTABL LIBRARY ID(TOPTABL) 


"SELECT CMD(%LIBHOME) NEWAPPL(TOP) PASSLIB 
/* "SELECT CMD(%LIBHOME) NEWAPPL(XXX) PASSLIB 

"LIBDEF ISPPLIB" 

"LIBDEF ISPMLIB" 

"LIBDEF ISPSLIB" 

"LIBDEF ISPTLIB" 

"LIBDEF ISPTABL" 

ADDRESS TSO 

"ALTLIB DEACTIVATE APPLICATION(*)" 

"FREE F(TOPPROC TOPPANS TOPMSGS TOPSKEL, 
TOPTLIB TOPTABL)" 

EXIT 


/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

"/’ 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 


TELL REXX ABOUT ISPF 
LIBDEFS FOR PANELS 
LIBDEFS FOR MSGS 
LIBDEFS FOR SKELS 
LIBDEFS FOR TLIBS 
LIBDEFS FOR TABLS 

‘GO ON WITH ONTOP 
GO ON WITH ONTOP 

CLEAR ISPMLIB ALLOCS 
CLEAR ISPMLIB ALLOCS 
CLEAR ISPSLIB ALLOCS 
CLEAR ISPTLIB ALLOCS 
CLEAR ISPTABL ALLOCS 

TELL REXX ABOUT TSO 
RESET APPL CLIST 
FREE LIBDEF DD NAMES 

OK. THAT'S IT !! 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


ONTOP start exec to customer interface 


Actions 

• do as requested under Hinweis 
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27. Using description 


r 


CUSTOMER NAME MUSTERFIRMA 


ONTOP Home Panel V7R3M3 - HHD * 


please select ===> 

USERID - ADAMM 

0 CUSTOMIZE - CUSTOMIZE ONTOP Proc - LOGHHD 

1 BROWSE - BROWSE on System-/Problem-Data 

2 EDIT - EDIT on Userid Data 

3 IPCS - Start IPCS 

4 EREP - Start EREP 

5 IND$FILE - PC Up/Down - Data exchange IBM2Cust (max 50 MB) 

6 - not defined yet 

7 - not defined yet 

8 - not defined yet 

9 TERSE - TERSE/UNTERSE a Dataset 

A SDSF - SDSF 

B ISPF - ISPF - Standard 


Press PF3 

V_ 


to Terminate ONTOP 

_ ) 


ONTOP Home Panel 


This is the ONTOP Home Panel. 

Just select the option you would like to use. 
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ONTOP Browse Panel 


If ISPF is not available, then BROWSE is the only way to get access to other data beside data 
under the userid qualifier. 
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27.2 Using ONTOP Edit 


TOPUDLP ******************************** 
* Customer Name customer 

'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 




* ONTOP Edit Panel * 


OPTION ===> 


blank - Display 
V - Display 


set list * 
information only 


P - Print data 
PV - Print VTOC 


set list 

information only 


data 

VTOC 


Only given Prefix Dsname are allowed: 
DSNAME LEVEL ===> ONTOP5 
VOLUME ===> 


INITIAL DISPLAY VIEW ===> VOLUME 

CONFIRM DELETE REQUEST ===> YES 


(VOLUME,SPACE,ATTRIB,TOTAL) 
(YES or NO) 


Press ENTER to execute, or 

V_ 


PF03 to return 


ONTOP Edit Panel 


The ONTOP Edit Panel is the place where the user can play around with it's own data. 
What means full responsibility for all the actions he does to it's own data. 
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27.3 Using IPCS 

27.3.1 Dump Environment Select List 



* CUSTOMER NAME MUSTERFIRMA * 


ONTOP Home Panel V7R3M3 - HHD * 


please select ===> 3 


USERID - ADAMM 


- DUMP Environment Select List - Row 1 to 5 of 5 

Command ==> Scroll ==> HALF 


Use ENTER to start IPCS with the asterisk flagged environment 
Use S to select a different dump envi -> ISPF restart 

Use PF01 for Help, PF07 for Backward, PF08 for Forward 


/390 ! 

IMS 

! CICS! 

DB2 

! JES2! 

VTAM!TCPIP! 

MQS 

! COMMENT 

!envi! 

-! 

— 

!-! 

— 

!-! 

-I-I 

— 

! BRINGUP 

! 01 ! 

607 ! 

610 

! 610 ! 

610 

! 270 ! 

270 ! 270 ! 

230 

! /390 2.07 

! 02 ! 

-! 

— 

!-! 

— 

!-! 

-I-I 

— 

! FREE 

! 03 ! 

-! 

— 

!-! 

— 

!-! 

-!-! 

— 

! FREE 

! 04 ! 

-! 

— 

!-! 

— 

!-! 

-j-j 

— 

! FREE 

! 05 ! 


Press PF3 to Terminate ONTOP 



ONTOP Dump Environment Selection Menu 


The first panel shown after selecting option 3 in the ONTOP Home Panel is the Dump 
Environment Select List (POP_UP TOPENVI). 

The active environment is always placed in the top line. 

If no other environment has to be chosen, just hit ENTER to go to IPCS. 
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27.3.2 IPCS Primary Option Menu 


r 

OPTION ===> 


IPCS PRIMARY OPTION MENU 


0 DEFAULTS 

1 BROWSE 

2 ANALYSIS 

3 UTILITY 

4 INVENTORY 

5 SUBMIT 

6 COMMAND 
T TUTORIAL 
X EXIT 


Specify default dump and options 
Browse dump data set 
Analyze dump contents 
Perform utility functions 
Inventory of problem data 
Submit problem analysis job to batch 
Enter subcommand, CLIST or REXX exec 
Learn how to use the IPCS dialog 
Terminate using log and list defaults 


USERID - HHDM3 
DATE - 98/03/09 
JULIAN - 98.068 
TIME - 13:11 
PREFIX - HHDM3 
TERMINAL- 3278 
PF KEYS - 24 




Enter END command to terminate IPCS dialog 


F1=HELP 
F 8 =BACKWARD 


F2=SPLIT 

F9=SWAP 


F3=END 

F10=LEFT 


F5=RFIND 
FI1=RIGHT 


F6=RCHANGE 
F12 =RE TRIEVE 


F7=FORWARD 




IPCS Primary Option Menu 


The IPCS Primary Option Menu (BLSPPRIM) is the first original IPCS Menu. 
Standard IPCS usage is performed here. 
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27.3.3 IPCS Default Values 


IPCS Default Values 


Command ===> 


You may change any of the defaults listed below. The defaults shown before 
any changes are LOCAL. Change scope to GLOBAL to display global defaults. 

Scope ==> LOCAL (LOCAL, GLOBAL, or BOTH) 

If you change the Source default, IPCS will display the current default 
Address Space for the new source and will ignore any data entered in 
the Address Space field. 

Source ==> DSNAME('ONTOP.GS033.P01818.DUMP01') 

Address Space ==> ASID(X'05FF') 

Message Routing ==> NOPRINT TERMINAL 

Message Control ==> CONFIRM VERIFY FLAG(WARNING) 

Display Content ==> NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL 


Press ENTER 

to update 

defaults. 



Use the END 

command to 

exit without 

an update. 


F1=HELP 

F2=SPLIT 

F3=END 

F5=RFIND 

F6=RCHANGE F7=FORWARD 

F 8 =BACKWARD 

F9=SWAP 

F10=LEFT 

F11=RIGHT 

F12 =RE TRIEVE 


V_ J 


IPCS Default Values 


Menu BLSPSETD is where the IPCS default values can be set. The way it acts, is predefined 
by member IPCSPROO in the PARMLIB. 

Remark: It is also possible, to go straight to Option 6 and use SETDEF to set the defaults. 
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27.3.4 IPCS Utility Menu 


IPCS UTILITY MENU 


******************** 


1 COPYDDIR - Copy dump directory data 

2 COPYDUMP - Copy a dump data set 

3 COPYTRC - Copy trace data 

4 DSLIST - Process list of data set names 

5 DAE - Process DAE data 


Enter END command to terminate 


* USERID 

* DATE 

* JULIAN 

* TIME 


- HHDM3 

- 98/03/11 

- 98.070 

- 11:22 


* PREFIX - HHDM3 

* TERMINAL- 3278 

* PF KEYS - 12 
******************** 


F1=HELP F2=SPLIT 

F8=BACKWARD F9=SWAP 


F3=END 

F10=LEFT 


F5=RFIND 

F11=RIGHT 


F6=RCHANGE 

F12=RETRIEVE 


F7=FORWARD 


IPCS Utility Menu 


Here are some utilities to handle IPCS data sets. 
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27.3.5 IPCS Subcommand Entry 



- IPCS Subcommand Entry - 

Enter a free-form IPCS subcommand or a CLIST or REXX exec invocation below: 




IPCS Subcommands and Abbreviations 


ADDDUMP 


| DROPDUMP, 

DROPD 


LISTMAP, 

LMAP 

| RUNCHAIN, 

RUNC 

ANALYZE 


| DROPMAP, 

DROPM 


LISTSYM, 

LSYM 

| SCAN 


ARCHECK 


| DROPSYM, 

DROPS 


LISTUCB, 

LISTU 

| SELECT 


ASCBEXIT, 

ASCBX 

| EQUATE, 

EQU, EQ 


LITERAL 


| SETDEF, 

SETD 

ASMCHECK, 

ASMK 

| FIND, 

F 


LPAMAP 


| STACK 


CBFORMAT, 

CBF 

| FINDMOD, 

FMOD 


MERGE 


| STATUS, 

ST 

CBSTAT 


| FINDUCB, 

FINDU 


NAME 


| SUMMARY, 

SUMM 

CLOSE 


| GTFTRACE, 

GTF 


NAMETORN 


| SYSTRACE 


COPYDDIR 


| INTEGER 



NOTE, 

N 

| TCBEXIT, 

TCBX 

COPYDUMP 


| IPCS HELP 

H 


OPEN 


| VERBEXIT, 

VERBX 

COPYTRC 


| LIST, 

L 


PROFILE, 

PROF 

| WHERE, 

W 

CTRACE 


| LISTDUMP, 

LDMP 


RENUM, 

REN 

1 



F1=HELP 

F8=BACKWARD 



F2=SPLIT 

F9=SWAP 


F3=END 

F10=LEFT 


F5=RFIND 
FI1=RIGHT 


F6=RCHANGE 

F12=RETRIEVE 


F7=F0RWARD 

_ J 


IPCS Subcommand Entry 


At panel BLSPDSLE all the Subcommands under IPCS are shown. This is probably the 
favorite place for software service people. 
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27.3.6 IPCS Setdef Display 


IPCS OUTPUT STREAM-Line 0 Cols 1 78 

Command ===> _ SCROLL ===> CSR 


TOP OF DATA 


/*- Global Default Values 

SETDEF GLOBAL NOPROBLEM 

SETDEF GLOBAL NOPRINT TERMINAL 

SETDEF GLOBAL FLAG(WARNING) 

SETDEF GLOBAL CONFIRM 
SETDEF GLOBAL NOTEST 

SETDEF GLOBAL DSNAME('ONTOP.GS 0 3 3.P 01£ 

SETDEF GLOBAL LENGTH(4) 

SETDEF GLOBAL VERIFY 

SETDEF GLOBAL DISPLAY(NOMACHINE) 

SETDEF GLOBAL DISPLAY( REMARK) 

SETDEF GLOBAL DISPLAY( REQUEST) 

SETDEF GLOBAL DISPLAY(NOSTORAGE) 

SETDEF GLOBAL DISPLAY( SYMBOL) 

SETDEF GLOBAL ASID(X'05FF') 


for IPCS Subcommands - 

/* Current problem number 
/* Routing of displays 
/* Optional diagnostic messages 
/* Double-checking major acts 
/* IPCS application testing 
18.DUMP01') 

/* Default data length 
/* Optional dumping of data 
/* Include storage keys, .... 

/* Include remark text 
/* Include model LIST subcommand 
/* Include contents of storage 
/* Include associated symbol 
/* Default address space 


SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 

SETDEF 


- Local Default Value 

NOPROBLEM 
FLAG(WARNING) 

CONFIRM 

NOTEST 

DSNAME('ONTOP.GS033.P0 
LENGTH(4) 

VERIFY 

DISPLAY(NOMACHINE) 
DISPLAY( REMARK) 

DISPLAY( REQUEST) 
DISPLAY(NOSTORAGE) 
DISPLAY( SYMBOL) 

ASID(X'05FF') 
***************** END OF 


s for IPCS Subcommands - 

/* Current problem number 
/* Optional diagnostic messages 
/* Double-checking major acts 
/* IPCS application testing 
1818.DUMP01') 

/* Default data length 
/* Optional dumping of data 
/* Include storage keys, .... 

/* Include remark text 
/* Include model LIST subcommand 
/* Include contents of storage 
/* Include associated symbol 
/* Default address space 


IPCS Setdef Display 

First thing someone should do before starting dump analyzing is have a look at the settings. 
By typing in SETDEF the IPCS settings for scope = GLOBAL and scope = LOCAL will be 
shown. 

If something is not like the user expects it to be, he must go back and change it in panel 
BLSPDSLE. 

Lor example the dsname can be changed by typing in: 

setdef dsn('aaaaaa.bbbbb.cccccc' 
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27.3.7 IPCS and printing 

To use the print function under IPCS the two IPCS print data sets 

userid.IPCSPRTN.TEMP 

userid.IPCSTOC.TEMP 

must be allocated, what is always true if you work under ONTOP. 

Further on you should check the settings at panel BLSPDSLE, by using SETDEF. 


27.3.8 IPCS Setdef Display 


r ^ 


IPCS OUTPUT STREAM-Line 0 Cols 1 78 

Command ===> _ SCROLL ===> CSR 




TOP OF DATA *********************************** 


/*- 


- Global Default Values 

for IPCS Subcommands - 

__*/ 

SETDEF 

GLOBAL 

NOPROBLEM 

/* Current 

problem number 

*/ 

SETDEF 

GLOBAL 

PRINT TERMINAL 

/* Routing 

of displays 

*/ 

SETDEF 

GLOBAL 

FLAG(WARNING) 

/* Optional diagnostic messages 

*/ 

SETDEF 

GLOBAL 

CONFIRM 

/* Double- 

checking major acts 

*/ 


SETDEF 

LOCAL 

DISPLAY( SYMBOL) 

/* 

Include 

associated symbol 

*/ 

SETDEF 

LOCAL 

ASID(X'05FF') 

/* 

Default 

address space 

*/ 




END OF DATA *********************************** 






IPCS Setdef Display 

If NOPRINT is shown it must be set to PRINT by typing SETDEF PRINT at panel 
BLSPDSLE. 

To make sure the print buffer is open just type in OPEN PRINT as well. If the buffer is 
already open, 

BLS21046I PRINT FILE(IPCSPRNT) is already open 

is displayed. This is just an information and doesn't cause any problem. 

Now you have to issue the IPCS command to retrieve the output you would like to see. In 
order to have it printed in IPCSPRNT you must browse over all the relevant data you like to 
see, to fill the buffer. Then you must issue a CLOSE PRINT and all the data seen during 
browse will be captured in IPCSPRNT. 

If you experience 

BLS2106I PRINT file not open 

during close, then your IPCS print buffer has not been open and no data is captured. 

Note 

Under ONTOP the procedure mentioned in the description above is automated. Just say 
"TOPPRT" somewhere in the IPCS environment and the data captured in IPCSPRNT will be 
displayed. 
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27.4 Using PC UP and Down 



Menu List Mode Functions Utilities Help 


ISRTSO ISPF Command Shell 

Enter TSO or Workstation commands below: 


Place cursor on choice and press enter to Retrieve command 

=> 

=> 

=> 

=> 

=> 

=> 

=> 

=> 

=> 

=> 


Fl=Help F3=Exit F10=Actions F12=Cancel 

V_ ) 


ONTOP PC UP and Down Menu 

When selecting option 5 at the ONTOP Home Panel, the ISPF command shell is displayed to 
allow the user to use PC up- and download. 

There must be IND$FILE on the host side and SEND/RECEIVE on the PC side. 

This Option is used, to exchange data between Customer/IBM. 

All data exchanged should be in tersed format and stay below 50MB. 

A typical exchange scenario is the transfer of IPCSPRNT data from Cust2IBM 

After having run an IPCS session all the format data generated during the session is captured 
in uid.IPCSPRNT.TEMP and this data can be transferred to IBM for further analysis, by: 

1. TERSE data (option 9 - output is suffixed by TERSED 

2. DOWNLOAD data (option 5 - PC command C:\receive 

3. UPLOAD data (option 5 - PC command C:\send 

4. UNTERSE data 

e.g. loading data from customer to PC 

C:\receive ipscprnt.tmp x:'uid.IPCSPRNT.TEMP.TERSED' 

e.g. loading data from PC to OS/390 

C:\send ipcspmt.tmp x: uid.IPCSPRNT.TRS' recfm(f) lrecl(1024) 
e.g. loading data from PC to VM 

C:\send ipcspmt.tmp x:IPCSPRNT TRS A (recfm f lrecl 1024 


17.10.01 


TSO/ONTOP Inst/Cust/Usage Guide 


77 









ONTOPA 


27.5 Using EREP 



******************************************************************************* 

* CUSTOMER NAME MUSTERFIRMA * 

******************************************************************************* 

* EREP Start Menu * 

******************************************************************************* 

OPTION ===> 

1 EREP1 - EREP Selection Menu 1 

2 EREP2 - EREP Selection Menu 2 (Multi-LOGREC, FREE Format Report) 

3 JOBOUT - Display Job Output, ISPF Opt. 3.8 

4 JOBOUT - Display Job Output, SDSF required 

5 OUTPUT - Display of EREP Results 

6 TAILOR - Tailor EREP 


History data set (ACCIN) 

-> 

N (Yes=Y, No=N) 

Select System === 

Select record Type or 'U' 

(all) 

===> u 

A ASYNC 

C CCH/CRW/SLH 

D 

DDR 

E EOD 

H MIH 

I 

IPL 

M MCH 

0 OBR 

S 

SOFTWARE 

T MDR 


Press PF3 to terminate and return to previous Panel PF1 HELP 

V_ J 


EREP Start Panel 


Menu TOPEREPO is the first EREP Option Menu. 

It offers a bunch of EREP reports, display of EREP job output, display of EREP results and 
EREP tailoring. 

Here only the EREP usage part is covered. 
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27.6 EREP Selection Menu 1 


TOPEREP1 ********************* 
* CUSTOMER NAME MUSTERFIRMA 


OPTION ===> 


EREP Selection Menu 1 

•k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'f i 


1 TREND - TREND Report 

2 SYSUM - SYSTEM SUMMARY Report 

3 SYSEXN - SYSTEM EXCEPTION Report 

4 EXCEPT - EXCEPTION Report by DEV and/or CUA 

5 DETAIL - DETAIL Report by DEV and/or CUA 

6 HISTORY - EVENT HISTORY Report 

7 EVENT - EVENT Reports by DEV and/or CUA 


(DEV/CUA optional) 
(DEV/CUA optional) 


Report start date (YYDDD) 
Report end date (YYDDD) 


===> 97364 
===> 97364 


Current date: ===> 97.364 
Default Search date: ===> 97 364 


Report start time 
Report end time 


===> 0000 
===> 2400 


DEV Type ===> (up to 4 Entries, Example: 3380,3420) 

CUA Addr ===> (up to 4 Entries, Example: 140,142,150 

Press PF3 to terminate and return to previous Panel PF1 HELP 


Panel TOPEREP1 

Menu TOPEREP1 is where predefined EREP reports can be selected. 


17.10.01 


TSO/ONTOP Inst/Cust/Usage Guide 


79 








ONTOPA 


27.7 EREP Selection Menu 2 



KUNDENNAME MUSTERFIRMA 


* EREP Selection Menu 2 (Multi-LOGREC and FREE-Format EREP Reports * 

•k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

OPTION ===> _ 


1 EVENT - EVENT HISTORY Report .after Temp.Accum. of LOGREC 

2 SYSEXN - SYSTEM EXCEPTION Report . 

3 DEVEXN - EXCEPTION Report by DEV or CUA " 

4 EVENT - EVENT Report by DEV or CUA ..." 

5 FREE - EREP Free Format Report 

- Option 1-4 - 

Current date: 97.364 

Report start date (YYDDD) ===> 97364 Report start time ===> 0000 

Report end date (YYDDD) ===> 97364 Report end time ===> 2400 


DEV Type ===> (up to 4 Entries, Example: 3380,3420) 

CUA Addr ===> (up to 4 Entries, Example: 140,142,150 

- Option 5 - 

Free Format enter PARMS:(ACC=N,ZERO=N,DATE=(88001,88006),CUA=180,EVENT=Y etc.) 

Contin==> N (N=no,Y=yes) ==> 

Press PF3 to terminate and return to previous Panel PF1 HELP 



Panel TOPEREP3 


Menu TOPEREP3 offers some predefined reports, as well, as the option to define reports in 
free format. 
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27.8 Outlist ISPF 3.8 


r 

ISRUOLOl 
Option ===> 


Outlist Utility 


L List job names/id's via the TSO STATUS command 
D Delete job output from SYSOUT hold queue 
P Print job output and delete from SYSOUT hold queue 
R Requeue job output to a new output class 
blank Display job output 

For Job to be selected: 

Jobname. . . 

Class. . . . 

Job ID . . . 

For Job to be requeued: 

New Output class. . . 

For Job to be printed: (A for ANSI ) 

Printer carriage control. . . (M for machine ) 

(Blank for none) 


Fl=Help F3=Exit F12=Cancel 



ISPF Outlist 3.8 


This Panel is the standard ISPF 3.8 panel. If there is no SDSF available, this panel has to be 
used to display job output. 
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Panel TOPTADOl 


The EREP Output Reporting Panel is where you can display and print EREP reports. 
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27.10 Using IFX 


r 

PFTNP10 - 

COMMAND ===> 


IBM IN File Exchange 


Specify details for Data Transfer request to a non RJE user 


Data set to be transferred: 
PROJECT ===> 

LIBRARY ===> 

TYPE ===> 

MEMBER ===> * 


Destination for transfer: 
USER ID ===> 

NODE ID ===> 


From other partitioned or sequential data set: 
DATA SET NAME ===> 

ACKNOWLEDGEMENT REQUIRED ===> YES (YES/NO) 


Optional parameters: 
System Type ===> 


PF1 Help 
F1=HELP 


F7=UP 

V_ 


PF3 End 

F2=SPLIT 

F8=DOWN 


ENTER Schedule request 

F3=END F4=RETURN 

F9=SWAP F10=LEFT 


F5=RFIND 
FI1=RIGHT 


F6=RCHANGE 
F12 =RE TRIEVE 


Panel PFTNP10 


If the IFX end user interface for NJE is installed, than this interface can be added to ONTOP, 
to allow ONTOP users to send data to IBM. 
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27.11 Using TERSE 



* CUSTOMER NAME MUSTERFIRMA * 

* ONTOP TERSE/UNTERSE Panel * 

•k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 


Please enter Option and Dataset to be TERSED/UNTERSED without apostroph 
Option: T (T)ERSE/(U)NTERSE 

DSname: _ 

This could take some time, so please be patient. 

For TERSE the output Dataset will be prefixed by USERID and suffixed "TERSED" 
For UNTERSE the output Dataset will only be prefixed by USERID 
TERSE and UNTERSE will erase Datasets conflicting with the name of the output 
Everything bigger than 50MB of raw data shouldn't be tersed for Upload to IBM 


Press ENTER to execute, or PF03 to return 



Panel TERSE 

Along with ONTOP the IBM tool to pack data, called TERSE is delivered. This panel can be 
used to invoke the tool. 
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28. Reader's Comments 


ONTOP V7R3M3 

Use this form to tell us what you think about this manual. If you have found errors in it, 
or if you want to express your opinion about it (such as organization, subject matter, 
appearance) or make suggestions for improvement, this is the form to use. 

To request additional publications, or to ask questions or make comments about the 
function of IBM products or systems, you should talk to your IBM representative or to 
your IBM authorized remarketer. This form is provided for comments about the 
information in this manual and the way it is presented. 

When you send comments to IBM, you grant IBM a nonexclusive right to use or 
distribute your comments in any way it believes appropriate without incurring any 
obligation to you. 

Be sure to print your name and address below if you would like a reply, or provide your 
FAX telephone number if you would prefer a FAX response. S FAX 06131-84-6611 


Name: 


Adress: 


Company or Organization: 


Phone No: 


Reader Comment 
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Reader’s Comment 
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Fold here 


IBM Deutschland Informationssysteme GmbH 
c/o Heinz Dieter Hassinger/Alexander Damm 
Kostenstelle 7420 
Hechtsheimerstr. 2 
D-55131 Mainz 


Fold here 


Reader Comment 2 
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